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PREFACE 


This document contains a comprehensive description of the PDP-11 Disk 
Operating System Monitor. The document is written for the PDP-11 pro- 
grammer -- it assumes familiarity with the contents of the PDP-11 
Handbook 1971 and the PAL- HR Assembler (see document number DEC-11- 
ASDA-D) . Previous experience with monitor or executive systems would 
be helpful, but is not necessary. 

The document is separated into three chapters : 

Chapter 1 is an introduction to the DOS Monitor, 
and provides general information about the disk operating system. 

Chapter 2 describes the programmed requests that are 

f 

available to the programmer through the Monitor. This chapter 
also explains the concepts and operation of each programmed re- 
ques t . 


Chapter 3 describes the keyboard commands available 
to the system operator through the Monitor; concepts and operation 
of each command is also explained. 

The entire document is summarized in the appendixes. 
Appendixes D (Monitor Commands) and E (Monitor Programmed Requests) 
should prove to be invaluable to the DOS user. 


The PDP-11 Disk Operating System software consist of, 
in addition to the DOS Monitor: 


PAL- 11R Assembler 
Edit-11 Text Editor 
0DT-11R Debugging Program 
PIP, File Utility Package 
Link-11 Linker 
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CHAPTER 1 


INTRODUCTION 


1.1 THE DOS MONITOR 

The PDP-11 Disk Operating System (DOS) Monitor supports the PDP-11 user 
throughout the development and execution of his program by: 

• providing convenient access to system programs and utilities 
such as the DOS assembler, debugger, editor, file utility 
package, etc.; 

• performing input/output transfers on three different levels, 
ranging from direct access of device drivers to full format- 
ting capabilities; 

• handling secondary storage management with two different 
kinds of file structure. 

System programs and utilities can be called into core from the 
disk or DECtape with Monitor commands issued from the keyboard. This 
feature eliminates the need to manipulate numerous paper tapes, and 
provides the user with an efficient and convenient programming tool. 

All input/output (I/O) transfers are handled by the Monitor in any 
of three user selected levels called READ/WRITE, BLOCK, and TRAN. 

READ /WRITE is a file structured, formatted level of I/O in which the 
user can specify any one of nine modes. BLOCK is a file structured, 
random access I/O level with no formatting. TRAN does basic I/O opera- 
tions at the device driver level. All I/O is concurrent and interrupt 
driven. 

The file system on secondary storage uses two types of file 
structures: linked and contiguous. Linked files can grow serially 

and have no logical limit on their size. Contiguous files must have 
their length specified but can be randomly accessed by BLOCK level I/O 
requests. Files can be deleted or created at any time, and are referred 
to by name. Table 1-1 summarizes the features and benefits of the 
Monitor. 

The user communicates with the Monitor in two ways: through pro- 
grammed instructions called requests , and through keyboard instructions 
called commands. 
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TABLE 1-1 


PDP-11 DOS MONITOR FEATURES AND BENEFITS 


Feature 

Benefits to User 

Files are catalogued in multi- 
level file directories. 

No file naming conflicts among 
users . 

Files are referred to by 
name . 

Files do not have to be remem- 
bered by number. 

Files can grow serially. 

Files can be created even when 
their final size is not known. 

Files can be as large as the 
storage device can accept. 

No logical limit on the size of 
files . 

File storage is allocated dy- 
namically from any bulk-stor- 
age device. 

Files can be deleted or created 
even at run time for greater 
storage efficiency. 

Monitor subroutines can be 
swapped into core when needed. 
Routines need not permanently 
tie up an area of core. 

Much more efficient use of core 
space for user programs. Free 
core expands and contracts as 
Monitor subroutines are used. 

Space can be reclaimed for user 
Programs . The user can determine 
which Monitor subroutines will 
be in core, and when. 

Monitor subroutines can be 
made permanently core resi- 
dent either before or during 
run time. 

The user can tailor the Monitor 
for his particular needs. 

The Monitor is divided into 
logical modules. 

The user can easily and cheaply 
use the logical pieces of the 
Monitor for his own needs. The 
user can also easily add his own 
specialized drivers to the system 
by following a simple set of 
rules, and still use the rest 
of the Monitor with these drivers. 

All I/O is interrupt driven. 

Such specialized equipment as 
communications modems and A/D 
converters which must be inter- 
rupt driven can be run through 
the Monitor. Several I/O calls 
can be handled concurrently. 


(continued on next page) 
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Table 1-1 (continued) 


Feature 

Benefits to User 

Device independence 

Specific devices can be speci- 
fied by the user in his program, 
and any device can be substitu- 
ted by him when his program is 
being run. 

Devices are assigned to 

User may reassign a device which 

Datasets . 

is used for one purpose, (Dataset) 


without changing its assignment 
for all other purposes (Datasets) . 


Programmed requests are macros which are assembled into the 
user's program and through which the programmer specifies the opera- 
tion to be performed. Some programmed requests are used to access 
input/output transfer facilities,- and to specify where the data is. 
where it is going, and what format it is in. In these cases the Mon- 
itor will take care of bringing drivers in from disk, performing 
the da>ta transfer, and notifying the user of the status of the trans- 
fer. Other requests access Monitor facilities to query system vari- 
ables such as time of day, date, and system status, and to specify 
special functions to devices. 


Keyboard commands enable the operator to load and run programs. 


specific addresses, modify the contents of memory registers, and 
retrieve system information such as time of day, date, and system 
status . 


Programs supported under the DOS, and hence accessible through 
the Monitor, are listed in Table 1-2. 
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TABLE 1-2. THE DOS SYSTEM PROGRAMS 


System Program 
PAL- HR Assembler 
Edit-11 Text Editor 
0DT-11R Debugging Program 
PIP, File Utility Package 
Link-11 Program Linker 


Document Number 
DEC -11 -ASDA-D 
DEC - 1 1 -EDDA-D 
DEC - 1 1 -ODDA-D 
DEC-ll-PIPA-D 
DEC -11 -LLDA-D 


1. 2 MONITOR CORE ORGANIZATION 
Core is divided into: 

• a user area where user programs and buffers are located; 

• the stack, where parameters are stored temporarily during 
the transfer of control between routines; 

• the free core or buffer area which is divided into 16-word 
blocks assigned by the Monitor for temporary tables, for 
device drivers called in from disk, and for data-buf fering 
between devices and user programs; 

• the resident Monitor itself which includes all permanently 
resident routines and tables; 

• the interrupt vectors . 

Figure 1-1 shows a map of core as organized by the Monitor. 
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MONITOR 


i 


Interrupt 
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Figure 1-1. The Monitor Core Map. 
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The smallest configurations adequate 
are: 

Configuration A: 1 

1 

1 

1 

1 

1 

1 

Configuration B: 1 

1 

1 

1 

1 

1 


to run the PDP-11 DOS Monitor 


PDP-11/20 with 8K of core 

ASR-33 Teletype terminal 

RC11 disk controller 

RS64, 64K fixed head disk drive 

TC11 DECtape controller 

TU56 dual DECtape transport 

BM792-YB Bootstrap Loader 

PDP-11/20 with 8K of core 

KSR-33 Teletype 

RF11 disk controller 

RS11, 256K fixed head disk drive 

PC11 high-speed paper tape reader/ 

punch 

BM792-YB Bootstrap Loader 


1-5 



1.4 MONITOR MESSAGES 


Monitor messages are stored on the disk. When a message-producing 
situation (such as a system error) occurs, the Monitor calls the 
correct message into core and prints it on the teleprinter. 

There are four types of Monitor messages: 

• Informational 

■ • Action required by the operator 

• Warning to the operator 

• Fatal . 

These message types are identified with the letters I, A, W and F 
respectively. If the system disk should fail and the error message 
cannot be brought into core, the Monitor halts. 

Monitor messages are described in detail in Section 2-10. 

The user may also store messages on the disk and call the ap- 
propriate Monitor routines to print them. The procedure for doing 
this is covered in Section D. 

1.5 HOW TO START THE MONITOR 

The monitor is loaded into core from disk by performing the follow- 
ing procedure: 


1. Place the address of the ROM Bootstrap Loader into the 
switches (773100) 

2. Depress Load Address switch 

3. Place the address of the word count register for the disk 
upon which the monitor resides (usually 177462 for RF/FS11) 

4. Depress START switch. 

The monitor will be loaded into core and identify itself by 
printing: 


MONITOR Vxxxx 
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on the teleprinter, were Vxxxx represents the version number of the 
Monitor being used. The Monitor is now ready to accept on operator 
command, (see Chapter 3) . 

1.6 A GUIDE TO THIS HANDBOOK 

1.6.1 Terminology 

The reader should understand the following terms as they apply to the 
Disk Operating System. An expanded glossary, with abbreviations, can 
be found in Appendix G. 

A dataset is a logical collection of data which is treated as an en- 
tity by a program. For example: 

• All or part of a file on a file-structured device. 

® A paper tape in a paper taoe reader . 

• Three physically different files which together constitute 
the source input to the assembler. 

A device is any PDP-11 peripheral supported by the Monitor. 

A device controller may support one or more device units . 

A file is a phusical collection of data which resides on a directory 
device and is referenced through its name. A file consists of one or 
more blocks on a directory device. 

A block is a broup of adjacent words of a specified size; it is the 
smallest addressable segment. If the blocks comprising a file are ad- 
jacent to each other, the file is said to be contiguous ; if the 
blocks of the file are not adjacent, the file is said to be linked . 

★ 

A line is a string of ASCII characters which is terminated by a LINE 
FEED, VERTICAL TAB, or FORM FEED. 

File Structure refers to the manner in which files are organized. 
Specifically, each of a user's files is given a unique name by the 
user. Each user on a file-structured device is assigned a User File 
Directory (UFD) in which each of his files is listed by name and lo- 
cation. Each UFD is then listed in a Master File Directory (MFD) 
which is unique to a specific device unit. 


* 


ASCII stands for American Standard Code for Information Interchange. 
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Bulk storage devices containing directories are called directory de- 
vices or file-structured devices. Devices such as paper tape equipment 
* 

and the Teletype, which cannot support a file structure, are called 
non-directory devices or non-file-structured devices . 

1.6.2 Standards for Tables 

A table is a collection of data stored in sequential memory locations. 
Figure 1-2 shows how a typical table is represented in this manual. 
This table is two words long, and is referenced by the symbolic ad- 
dress TABL: . The first entry is at location TABL and contains ENTRY 
A, which might be coded as .WORD AYE in the user's program. The second 
word of the table, at address TABL+2, is divided into two bytes. The 
low order byte (address TABL+2) contains ENTRY B, and the high order 
byte (address TABL+3) contains ENTRY C. They might be written into a 
program as .BYTE BEE, CEE. 

a) Representation in manual: 


TABL: 


ENTRY A 


ENTRY C 


ENTRY B 


b) Representation in program listing: 

TABL: .WORD AYE ; ENTRY A 

.BYTE BEE, CEE ; ENTRY B, ENTRY C 

1.6.3 Standards for Numbers 

Unless otherwise stated, all numbers in the text and examples are in 
octal . 


* 

Teletype is a registered trademark of the Teletype Corporation. 
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CHAPTER 2 


PROGRAMMED MONITOR REQUESTS 


2.1 INTRODUCTION 

The user program calls for the services of the Monitor through programmed 
requests . These requests are macro calls which are assembled into the 
user program and interpreted at execution time by the Monitor. A pro- 
grammed request consists of a one-word instruction followed, when approp- 
riate, by one or more arguments. For example: 

.WAIT LNKBLK 

is a programmed request called .WAIT followed by an argument LNKBLK. 

The macro or request is expanded at assembly time by the DOS Assembler 
into a sequence of instructions which trap to and pass the arguments to 
the appropriate Monitor routine to carry out the specified function. 

The assembly language expansion for .WAIT LNKBLK is: 

MOV # LNKBLK,- (SP) 

EMT 1 


The user may code a request in his program as either a macro call 
or as the equivalent assembly language program. 


The request arguments are parameters or addresses of tables which 
contain the parameters of the request. These tables are also part of 
the user program, and are described in detail in Figures 2-5 to 2-12. 
Restrictions on argument names are found in the appropriate PDP-11 
Assembler manual. 


Services which the Monitor makes available to the user through 


diLLiLLOVa J_ Lit 


• requests for input/output and related services 

• requests for directory management services 

• requests for miscellaneous services 


Table 2-1 summarizes the programmed requests available under the 
Monitor. They are described in general in Section 2.2. 
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TABLE 2-1. SUMMARY OF MONITOR REQUESTS. 


Mnemonic 

Purpose 

l 

Requests for Input/Output and related services: 

• INIT 

Associates a dataset with a device driver and sets 
up the initial linkage. 

.RLSE 

Removes the linkage between a device driver and a 
dataset, and releases the driver. 

• OPENx 

Opens a dataset. 

.CLOSE 

Closes a dataset. 

.READ 

Transfers data from a device to a user # s line 
buffer. 

.WRITE 

Transfers data from a user*s line buffer to a 
device. 

.WAIT 

Waits for completion of any action on a dataset. 

• WAITR 

Checks for completion of any action on a dataset, 
and provides a transfer address for a busy return. 

.BLOCK 

Transfers one block of a file between a device and 
a Monitor buffer. 

.TRAN 

Transfers data by absolute device block address 
between a device and a user buffer. 

.SPEC 

Performs special device functions. 

.STAT 

Obtains device characteristics. 

Requests for Directory Management services: 

.ALLOC 

Allocates a contiguous file. 

.DELET 

Deletes a file. 

•RENAM 

Renames a file. 

•APPND 

Appends one linked file to another. 

.LOOK 

Searches the directory for a particular filename 
and returns information about the file. 

• KEEP 

Protects a file against automatic deletion on 
Finish. 

Requests for Miscellaneous services: 


•EXIT Returns control to the Monitor, 

•TRAP Sets interrupt vector for the TRAP instruction, 

•RSTRT Sets the address used by the REstart command, 

(continued on next page) 
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Mnemonic 

Purpose 

— 

.CORE 

Obtains address of highest word in core memory. 

.MONR 

Obtains address of first word above the resident 
Monitor. 

• MONF 

Obtains address of first word above the Monitor's 
highest allocated free core buffer. 

.DATE 

Obtains the date. 

.TIME 

Obtains the time of day. 

•GTUIC 

Gets current UIC. 

•RADPK 

Packs three ASCII characters into one Radix-50 word. 

.RADUP 

Unpacks one Radix-50 word into three ASCII characters. 

•D2BIN 

Converts five decimal ASCII characters into one 
binary word. 

. BIN2D 

Converts one binary vord into five decimal ASCII 
characters. 

•02BIN 

Converts six octal ASCII characters into one binary 
word. 

• BIN20 

Converts one binary word into six octal ASCII 
characters. 

.CSIX 

Condenses a command string and checks for proper 
syntax. 

• CSI2 

Interprets one command string dataset specification. 


2.2 TYPES OF PROGRAMMED MONITOR REQUESTS 

2.2.1 Requests for Input /Output and Related Services 

Input/Output (I/O) under the Monitor consists of transferring the con- 
tents of a dataset between a device and a line buffer. A. line buffer 
is an area set up by the user in his program, into which he (or the 
Monitor) places data for output (or input) . The line buffer may be 
preceded by the line buffer header , in which the user specifies the 
size and location of the line buffer and the mode (format) of the data. 

All user I/O is handled by programmed requests, which provide 
three different levels of transfer: 

• READ/WRITE 

• BLOCK 

• TRAN 
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Each level uses a sequence of requests to complete the transfer. Note 
the distinction between READ /WRITE, BLOCK, and TRAN as names of trans- 
fer levels, and .READ, .WRITE, .BLOCK, and .TRAN as specific requests 
within these levels. 

Requests for I/O related services perform special device functions 
(such as rewinding a tape) and obtain device characteristics from device 
status words. 

2. 2.1.1 READ/WRITE Level Requests — This is the level at which the 
Monitor performs most of its services for the user. It is the most 
commonly used level of transfer. Among its users are the DOS Assembler 
and Edit-11 Text Editor programs, which input one line of ASCII charac- 
ters at a time. 

The READ/WRITE user can specify nine different modes of transfer, 
in two categories: ASCII and Binary. Each mode is presented briefly 
here; more details are in Section 2.6.1 and Figure 2-10. 

ASCII Modes: Formatted ASCII Parity - Special 

Formatted ASCII Parity - Normal 
Formatted ASCII Nonparity - Special 
Formatted ASCII Nonparity - Normal 
Unformatted ASCII Parity - Normal 
Unformatted ASCII Nonparity - Special 

Binary Modes: Formatted Binary - Special 

Formatted Binary - Normal 
Unformatted Binary - Normal 

1. Formatted and Unformatted Modes : Data in formatted ASCII 
modes is assumed by the Monitor to be in strings of ASCII characters 
terminated by LINE FEED, FORM FEED, or vertical TAB. DOS Assembler 
source programs use the formatted ASCII mode. In these modes, the 
Monitor manages all device-dependent conversions such as converting 
a TAB character to spaces when it is output to the line printer. 

Data in unformatted ASCII modes is also assumed to be in strings 
of ASCII characters, but the Monitor does not check for terminators or 
make device-dependent conversions. 
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2. ASCII Parity and Nonparity Modes : In ASCII nonparity modes, 
7-bit ASCII characters are transferred. 

In formatted ASCII parity modes, even parity is generated in the 
8th bit and is checked during the transfer. In unformatted ASCII par- 
ity mode, 8 bits are transferred, but no parity is generated or checked. 

3. Normal and Special Modes : All normal modes are compatible 
with their counterparts in the PDP-11 I/O Executive (IOX) . Special modes 
provide additional facilities to these normal modes. 

4. Formatted and Unformatted Binary Modes : Data in formatted 
binary modes is transferred in 8-bit bytes as read from the device. 

The Monitor makes no assumptions about the nature of the data, but cal- 
culates and verifies a checksum and byte-count. The binary output of 
the DOS Assembler is in a formatted binary mode. 

Unformatted binary mode is the same as formatted binary except 
that no checksum or count is calculated or verified. 

To implement a READ/WRITE transfer, the programmer follows the 
sequence of requests shown in Figure 2-lb. First, the programmer initial- 
izes the device to the dataset with the . INIT request. The argument of 
this request is the address of a table called the Link Block. Entries 
in this table specify the device involved in the approaching transfer 
so that the Monitor may eventually establish a link between that device 
and the dataset. The Link Block is described in detail in Figure 2-5. 

The .INIT calls the appropriate device driver into the free^ core buffer 
area, if it is not already there. 

Following the .INIT request, the programmer opens a dataset with 
ctn OPENx iT0C7U0st» This n 00c! b 0 dons onl^ 7 if thG d 0 v i c 0 bGi^icr us ©cl hss 
a directory. However, it is advisable to use an .OPENx even for a non- 
directory device to preserve the device independence of the program, 
i.e., the programmer may want to assign the transfer to a directory de- 
vice later. The argument of this request is the symbolic address of a 
table called the Filename Block (Figure 2-6) . Entries in this table 
specify the dataset involved in the transfer. 

There are several ways that a dataset can be opened. It can be 
opened for input, for output, for update, or for extension. The last 
letter of the .OPENx request specifies which type of open desired a 
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Figure 2-la. The Transfer Path. 


• INIT LNKBLK 


.OPENI LNKBLK, FILBLK 
— > .READ LNKBLK , BUFHDR 
.WAIT LNKBLK 

I 

(Process Data) 


.CLOSE LNKBLK 



{FOR OUTPUT, REPLACE .OPENI 
j WITH . OPENO 
I FOR OUTPUT, REPLACE .READ 
l WITH .WRITE 

{COULD BE REPLACED BY • WAITR 


•RLSE LNKBLK 

LNKBLK i (entries) "1 

FILBLK i (entries) > Tables in User's Program 

BUFHDR i (entries) j 


Figure 2-lb, Sequence of Requests for READ/WRITE. 


Figure 2-1. .READ/. WRITE Input/Output Transfers. 
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Either 


.READ (for input) or a .WRITE (for output) follow the .OPENx. 
request causes a transfer to take place between the line buffer and the 


arguments of either request are the address of the Link Block for the 
dataset and the address of the Line Buffer Header (Figure 2-8). The 
Line Buffer Header specifies the area in the user's core area to or from 
which the dataset is to be transferred. 


.READ or .WRITE are followed by .WAIT, which tests for the comple- 
tion of the last transfer, and passes control to the next instruction. 
Typically, what follows a .WAIT on an input is a subroutine to process 
the portion of data just input. When the process has been completed, 
the program checks to see if it wants another portion of data; if it 
does, the program transfers control back to the .READ request and the 
process is repeated. If the data has all been transferred, the .CLOSE 
request follows to complete any pending action, update any directories 
affected, and release to free core any buffer space the Monitor has al- 
located from free core. Finally, action on the dataset is formally 
terminated with the . RLSE request, which dissociates the device from 
the dataset, and releases the driver. Releasing the driver frees core 
provided there is no other claim to the driver from another dataset. 

2. 2. 1.2 BLOCK Level Requests — BLOCK requests provide for random access 
of blocks in files stored in directory devices such as the disk or DEC- 
tape. An example of a BLOCK user program is a Payroll Update Program 
which stores information about all employees on one file, with a set 
number of blocks assigned to each employee. 

At this level, data is transmitted between a specified block of 
the file and the Monitor Buffer (Figure 2-2a) . The user program may 
directly access the data in the Monitor buffer, or may move it to his own 
area for further processing. BLOCK level requests require the use of 
the .INIT, .RLSE, .OPEN and .CLOSE requests, as in the READ /WRITE level 
requests . 

To implement a BLOCK transfer, the programmer follows the sequence 
of requests shown in Figure 2-2b. Notice that the transfer must be 
ini ted, opened, waited, closed, and released following the same rules 
as the READ/WRITE level. The .BLOCK request has the address of the 
link block and the BLOCK block for its arguments. The BLOCK block 
specifies the block within the file that is to be transferred. 
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Figure 2-2a. The Transfer Path. 


. INIT LNKBLK 
.OPENU LNKBLK, FILBLK 

.BLOCK LNKBLK, BLKBLK j INPUT DESIRED BLOCK 

.WAIT LNKBLK jCOULD BE REPLACED BY . WAITR 

(Process Data) lUPDATE DATA 


.BLOCK LNKBLK, BLKBLK j WRITE UPDATED BLOCK 
.WAIT LNKBLK 
.CLOSE LNKBLK 


•RLSE LNKBLK 


LNKBLK i 
FILBLK * 
BLKBLK * 


(entries) "] 

(entries) > Tables in User Program 
(entries) J 


Figure 2-2b. 


The Sequence of Requests For .BLOCK. 


Figure 2-2, .BLOCK Input/Output Transfers. 
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2. 2. 1.3 TRAN Level Requests — A TRAN level request is a basic input/ 
output operation at the device driver level. Bulk storage devices are 
accessed by absolute block number without regard to file structure. For 
this reason, the user should be very careful not to destroy any files on 
the device on which he is performing TRAN level requests. He should al- 
locate a contiguous file on the device for his purposes. 

Data is transferred directly between the device and the user's line 
buffer (Figure 2-3a) with no formatting performed. TRAN level requests 
are generally used in two situations: 


• when the file structure does not allow the desired opera- 
tion (for example, PIP uses TRAN to read a directory block) 

• when the user cannot afford the overhead of doing transfers 
by a READ/WRITE process, and the data is of a fixed format. 
(For example, a program to process data arriving at random 
intervals from an A/D converter might first dump the input 
data onto the disk via a .TRAN request as it arrives, and 
then read it back later for processing when time permits.) 


To implement a TRAN transfer, the programmer follows the sequence of re- 
quests shown in Figure 2-3b. Notice that the transfer must be INITed 
and . RLSE'd, but is not . OPENed or .CLOSEd. The .TRAN request has the 
address of the TRAN Control Block as its argument. This block contains 
entries which specify the core starting address of the user's line buf- 
fer, the device block address, the number of words to be transferred, 
and the function to be performed. TRAN is therefore a device dependent 
request. A summary of the transfer levels which can be used on the 
various types of datasets is shown in Table 2-2. 

TABLE 2-2. TRANSFER LEVELS FOR TYPES OF DATASETS. 


Type of Dataset 


Type of 
Transfer 

Linked 

File 

Contiguous 

File 

Non-File-Structured 

Device 

READ/WRITE 

Yes 

Yes 

Yes 

BLOCK 


Yes 


TRAN 

* 

* 

Yes 


Yes indicates that the given transfer level will work on the 
given type of dataset. 

* indicates that TRAN may be used on a file structured de- 
vice if the warnings mentioned earlier are observed. 
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Figure 2-3a. The Transfer Path. 


. INIT LNKBLK 

i 

.ALLOC LNKBLK, FILBLK,N ;MAKE SPACE AVAILABLE FOR TRAN 

I 

.TRAN LNKBLK, TRNBLK 

.WAIT LNKBLK ; WOULD BE REPLACED BY . WAITR 

I 

(Process Data) 

I 

•RLSE LNKBLK 


LNKBLK i 
FILBLK i 
Ni 

TRNBLK t 


(entries) 

(entries) 

(entries) 

(entries) 


Tables and parameters 
in User Program 


Figure 2-3b. The Sequence of Requests For .TRAN. 


Figure 2-3. .TRAN Input/Output Transfers 
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2.2.2 Requests for Directory Management Services 


Directory management requests are used to enter file names into direc- 
tories, search for files, update file names, and protect files against 
deletion. 


2.2.3 Requests for Miscellaneous Services 
Requests for miscellaneous services include: 


Requests to return control to the Monitor from a running 
program. 

Requests to set Monitor parameters such as the TRAP vector 
or a program's restart address. 


Requests to obtain Monitor parameters such as the size of 


k -I- Vi s~\ v\ A +- 

• Clio riUuj. L 


current user's UIC. 


Requests to perform conversions between ASCII and Radax-50 
packed ASCII, binary and ASCII decimal, and binary and 
ASCII octal. 


Requests to access the Command String Interpreter. 


2.3 DEVICE INDEPENDENCE 

Ordinarily, a programmer specifies input/output devices as he writes 
the program. However, there are circumstances when he will want to 
change the device specification when his program is run. For example: 


• A device that the user specified when he wrote his program 
is not in operation at run time, but an alternate device 
is available. 

m The. programmer does not know, the conf iguration of the sys- 

tem for which he is writing, or does not wish to specify 
it (i.e., he is writing a general purpose package). 


The Monitor allows the programmer to write programs which are device 
independent in that the programmer can, but need not always, specify a 
device in his program. These facilities are: 


• The programmer may specify a device for each dataset via 
a Link Block when he writes his program. 

• A programmer can assign or reassign a device for a dataset 
through the keyboard with the ASsign command (Section 3. 3. 1.1) 
at run time. This command sets up a table entry in the Moni- 
tor which effectively overrides any entries in the Link 
Block . 
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Note of course that the substituted devices must be compatible. For 
example, the user may initially specify a BLOCK transfer from disk and 
later change the assignment to input from DECtape instead. But he can- 
not later specify paper tape reader as the input device, since BLOCK 
level requests do not apply to non-file structured devices. 

It is important to note that a device is assigned in a program 
to a dataset logical name and that reassigning a device at run time for 
one dataset logical name does not reassign that device for all dataset 
logical names to which it was originally assigned. 

The only transfer request which is not device independent is .TRAN. 


2.4 SWAPPING ROUTINES INTO CORE 

Except for a small, permanently resident kernel, the Monitor routines 
which process most programmed requests are potentially swappable. They 
are normally disk resident and are swapped into core by the Monitor only 
when needed. The user may, however, specify that one or more of these 
potentially swappable routines be made permanently core resident or core 
resident just for the duration of his program's run. Making a potential- 
ly swappable routine core resident ties up core space, but speeds up 
operation on the associated request. The user may, for example, be col- 
lecting data via a .TRAN request in a real-time environment. In such a 
case, even the short time needed to swap in the .TRAN request processor 
could cause him to lose data. 

Potentially swappable routines are listed in Appendix E. 

• Routines may be made permanently core resident in the Moni- 
tor by specifying the appropriate GLOBAL NAME at system 
generation time. 

• Routines may be made resident for the duration of a program's 
run by declaring the appropriate GLOBAL NAME (as specified 

in the definition of each request in Sections 2.6 through 
2.8) in a .GLOBL assembler directive in the program. For 
example, to make the .READ processor resident while program 
FROP is being run, the following directive would be included 
in the program FROP: 

.GLOBL RWN. 
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In the absence of either of the above specifications for a 
routine, the Monitor will swap in that routine whenever it 
is requested. 




2.5 MONITOR RESTRICTIONS ON THE PROGRAMMER 

In return for the services provided by the Monitor, the programmer must 
honor some restrictions : 

• The programmer should not use either the EMT or the IOT in- 
structions for communication within his program. 

• It is recommended that the user does not raise his interrupt 
priority level above 3, since it might lock out a device 
that is currently trying to do input/output. 

• HALTS are not recommended. If a HALT is executed during 
an I/O operation most devices will stop, and only recovery 
from the console (pressing the CONTINUE switch on the con- 
sole) will be effective (recovery from the keyboard will 
not be immediately possible, since a HALT inhibits the key- 
board interrupt). Some devices, such as DECtape , will not 
see the HALT and will continue moving, will lose their posi- 
tions over the block under transfer, and may even run tape 
off the reel. 


The RESET instruction should not be used because it forces 
a hardware reset, clearing all buffers and flags and dis- 
abling all interrupts, including the keyboard's. Since all 
I/O is interrupt driven, RESET will disable the system. 


• The user must be careful to avoid penetrating the Monitor 

when he is using the stack. The stack is set by the run 
time loader just below the lowest address of the program 
loaded. The Monitor checks to see that the stack is not 
overflowing each time it honors a request. The user can 
relocate the stack pointer and claim more space as follows : 


a. He can determine where the pointer is currently 
and where the current top of Monitor is located, 
then move the stack pointer down the correct 
amount. 

b. He can ask the Monitor for buffer space via the general 
utilities (see PDP-11 DOS Monitor, System Programmer's 
Manual) . 

• The user should be aware that certain instructions, such 

as . INIT , may change the amount of available free core, since 
they may call in drivers and establish data blocks. Such 
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requests effect the results of the MONR or MONF requests. 

• Certain requests return data to the user on the stack. The 
user must clear the stack himself before the stack is used 
again. The Monitor clears the stack after it honors re- 
quests that do not return data to the user on the stack. 

• The user should not use GLOBAL names that are currently used 
by the Monitor. All these names are listed in Appendix E. 

2. 6 DEFINITION OF REQUESTS FOR INPUT/OUTPUT SERVICES 

Each request has one or more arguments which are addresses of tables in 
the user's program. The tables specify the variables of the request. 
Table entries are explained in detail in Figures 2-5 to 2-12 at the end 
of this section. 

2.6.1 READ /WRITE Level Requests 

This is the level at which the Monitor performs most of its services for 
the user. The user can specify nine different modes of transfer, in 
two categories; ASCII and Binary. Each mode is discussed here, and is 
presented in detail in Figure 2-10. 

ASCII Modes: Formatted ASCII Parity - Special 

Formatted ASCII Parity - Normal 
Formatted ASCII Nonparity - Special 
Formatted ASCII Nonparity - Normal 
Unformatted ASCII Parity - Normal 
Unformatted ASCII Nonparity - Normal 

Binary Modes: Formatted Binary - Special 

Formatted Binary - Normal 
Unformatted Binary - Normal 

1. Formatted and Unformatted Modes: 

Data in formatted ASCII modes is assumed by the Monitor to be in 
strings of 7- or 8-bit ASCII characters terminated by LINE FEED, 
FORM FEED or vertical TAB. PAL-11R Assembler source programs are 
in a formatted ASCII mode. In these modes, the Monitor manages 
all device-dependent conversions at the driver level. For example, 
LINE FEED is supplied after RETURN in character strings from key- 
board terminals . 
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Data in unformatted ASCII modes is also assumed to be in strings 
of 7- or 8-bit ASCII characters. Checks for terminators and device- 
dependent conversion are not performed by the Monitor, thus allow- 
ing the user to handle all characters in his own way. 

2. ASCII Parity and Nonparity Modes: 


In ASCII nonparity mudes , 


7-bit ASCII characters are transferred. 


In formatted ASCII parity modes, even parity is generated in the 
8th bit and is checked during the transfer. In unformatted ASCII 
parity mode, 8 bits are transferred, but no parity is generated 
or checked. 


3. Normal and Special Modes: 

Special modes provide additional Monitor facilities over and above 
normal modes; normal modes are compatible with the PDP-11 I/O Exe- 
cutive (IOX) . 

4. Formatted and Unformatted Binary Modes: 

Data in formatted binary modes is transferred in 8-bit bytes as 
read from the device. The Monitor makes no assumptions about the 
nature of the data. A checksum is calculated during a WRITE re- 
quest and transmitted with the data, as well as a count of the 
number of bytes. The checksum is verified during a READ. The bi- 
nary output of the PAL-11R Assembler, for example, is in a for- 
matted binary mode. 

Unformatted binary mode is the same as formatted binary except 
that no checksum or count is calculated or verified. 

2. 6. 1.1 . INIT 

Associate or initialize a dataset with a device driver and set up the 
initial linkage between them. 

Macro Call : . INIT LNKBLK 

where LNKBLK is the address of the link block. 
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Assembly Language 
Expansion : 

MOV # LNKBLK,- (SP) 

EMT 6 

Global Name: INR. 

Description : Assigns a device to a dataset and makes sure that the 

appropriate driver exists and is in core. If the driver is not in core, 
it is swapped in. The device assigned is that specified in the associ- 
ated Link Block, unless assignment has been made with the ASsign com- 
mand. After the Init has been completed, control is returned to the 
user at the instruction following the assembly language expansion. The 
argument is removed from the stack. 

Rules : The user must set up a Link Block of the format shown 

in Figure 2-5 in his program for each dataset to be INITed. Another 
.INIT on a dataset for which no .RLSE has been given will effectively 
be a .RLSE followed by an .INIT except that no form of close will be 
performed. 

Errors : A non-fatal error message, number A003 , is printed on 

the teleprinter if no assignment has been made through the ASsign com- 
mand, and the DEFAULT DEVICE is either not specified in the Link Block 
or has been specified illegally (i.e., no such device on the system). 

The user may type in an assignment (ASsign) and type CO (continue) 
to resume operation. 

Control is transferred to the address specified by the 
Link Block if at any time during an operation there is not enough space 
in free core for the necessary drivers, buffers or tables. If no ad- 
dress (i.e., a zero) is specified in the Link Block's ERROR RETURN AD- 
DRESS, then a fatal error, number F007 , is printed and the program stops. 

Example : (see .RLSE). 


2. 6. 1.2 .RLSE 

Remove the linkage between a device driver and a dataset, and release 
the driver. 

Macro Call : . RLSE LNKBLK 

where LNKBLK is the address of the link block previously INITed. 
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Assembly Language 
Expansion : 

MOV #LNKBLK , - (SP) 
EMT 7 


Global Name: RLS. 


Description : Dissociates the device from the dataset and releases 

the dataset's claim to the driver. Releasing the driver frees core pro- 
vided no other dataset has claimed the driver. 

Rules : The device to be released must have previously been 

INITed to the dataset. 

If the dataset has been opened on a directory device, 
it must be closed before the device is released. 

After the release has been completed, control is re- 
turned to the user at the instruction following the assembly language 
expansion; the argument is removed from the stack. 

Errors : If the dataset has been .OPENed to a file structured 

device, a . RLSE not preceded by a .CLOSE will be treated as a fatal er- 
ror, F005. 

Example : 

. INIT LNKl 

.RLSE LNKl 

.WORD ERR1 
LNKl: .WORD 0 

.RAD50 /DS 1/ 

.BYTE 1,0 
. RAD50 /KB/ 

ERR1 : ERROR 

PROCESSING 


; ASSOCIATE A DATASET WITH A DEVICE 


; ERROR RETURN ADDRESS 
; POINTER FOR MONITOR 
; LOGICAL NAME OF DATASET 
; DEVICE SPECIFIED, UNIT 
; SPECIFY KEYBOARD 


2. 6. 1.3 .OPEN 

Prepares .INITed device for usage and makes a named file available if 
the device is directory oriented. 
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Macro Call: 


. OPENx 


LNKBLK , FILBLK 


Where x identifies type of OPEN. 

U for update 

0 for output 

E for extension 

1 for input 

C for contiguous create 
LNKBLK = address of Link Block 
FILBLK = address of Filename Block 


Assembly Language 
Expansion : 

MOVB iCODE, FILBLK- 2 ;MOVE "HOW OPEN" 

; CODE TO FILENAME BLOCK 

MOV #FILBLK,- (SP) 

MOV #LNKBLK,- (SP) 

EMT 16 

Where CODE indicates the type of OPENx request 

OPENO = 2 
OPENI = 4 
OPENU = 1 
OPENC =13 
OPENE = 3 

Global Name: OPN. (See Appendix C for subsidiary routines.) 


Description : In general an .OPENx request causes the Monitor to al- 
locate a data buffer and to make other necessary preparations for trans- 
ferring to a dataset to or from a device. More specifically: 


.OPENU opens a previously created contiguous file for input and output 
by .BLOCK. 

•OPENO creates a new linked file, and prepares it to receive output. 

.OPENE opens a previously created linked file to make it longer. 

.OPENI opens a previously created linked or contiguous file for input 
to the computer. It normally precedes all .READ operations. 

•OPENC opens a previously created contiguous file for output from the 
computer. 


After the open request has been processed, control is 
returned to the user at the instruction following the assembly language 
expansion; the arguments are removed from the stack. At this time, how- 
ever, the device concerned may still be completing operations required 
by the request. 

A summary of transfer requests which may legally 
follow OPEN requests is illustrated in Table 2-3. 
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TABLE 2-3. TRANSFER REQUESTS WHICH MAY FOLLOW OPEN REQUESTS 


1 A. NT »V<) 

Type of\^> N 
ODen 

Linked File 

Contiguous File 


Input 

Output 

Input 

Output 

File 

Already 

Exist? 

.READ 

.WRITE 

.READ 

.BLOCK 

.WRITE 

muss 

.OPENU 




YES 


YES 

must 

.OPENO 


YES 





must not 

.OPENE 


YES 





must 

.OPENI 

YES 


YES 

YES 



must 

•OPENC 





YES 


must 


Rules: General Rules for All .OPENx Requests 

a. The user must set up a Filename Block in his program (Figure 
2-6). If the dataset is a file, the Filename Block must contain 
a legal file name. A file name consists of up to six characters 
(A-Z, 0 - 9 ); the first character cannot be a digit { 0 - 9 ). If the 
dataset is not a file, the Filename Block need not contain an” 
FILENAME or EXTENSION* entries . ™ 


b. All datasets must have been INITed before they are OPENed. 


c. For datasets on directory devices, the User Identification 
Code (UIC) in the Filename Block (if specified) must be in the 
directory of the device. If the UIC is not specified, the user 
must have logged in with a UIC that appears on the device. 


d. The .OPENx request must not violate the protect code of the 
file. 


e. If a dataset is OPENed for any output, it cannot be OPENed 
again until it has been CLOSEd. 


Rules for .OPENO 


a. On a directory device, the .OPENO request is applicable only 
on outputs to a linked file or a non-directory device. 


2-19 



























b. The .OPENO request creates a linked file on a directory de- 
vice; hence, the file referenced in the corresponding Filename 
Block cannot exist prior to the .OPENO request. 


c. The .OPENO request will return an error if the directory is 
full. 


Rules for .OPENI 


a. .OPENI may be used for inputs from contiguous or linked files 
or non-directory devices. 


b. The file referenced in the corresponding Filename Block must 
exist on the directory. 


c. If a file is open for input (OPENI) , it cannot be OPENed for 
output, but it can be OPENed for extension or update. 


d. At any one time, a file can be opened for input a maximum 
of 62^ or 76g times. 

Rules for .OPENU, .OPENE and .OPENC 

a. The file must exist and cannot currently be opened for output 

b. The file cannot currently be opened by .OPENU, .OPENE or 
.OPENC. 

c. A contiguous file cannot be opened for extension. 

d. A linked file cannot be opened with .OPENC, which is appli- 
cable only to contiguous files. 

Errors : If any of the preceding rules are violated, the Moni- 

tor places an error code in the STATUS byte of the Filename Block (see 
Table 2-4) , and transfers control to the pointer in the ERROR RETURN 
ADDRESS of the Filename Block. If this address is 0, a fatal error 
message is printed on the console. Fatal error messages are listed 
in Section 2.10. 

Example: (See .CLOSE) 
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2. 6. 1.4 


.CLOSE 


Close a dataset. 


Macro Call: .CLOSE LNKBLK 

where LNKBLK is the address of the Link Block. 


Assembly Language 
Expansion : 


MOV # LNKBLK , - ( SP ) 
EMT 17 


Global Name: CLS . (See Appendix C for subsidiary routines.) 

Description : The close request indicates to the Monitor that no 

more I/O requests will be made on the dataset. Close completes any out- 
standing processing on the dataset, updates any directories affected by 
the processing, and releases to free core any buffer space established 
for the processing. For example, if .CLOSE had been preceded by an 
.OPENE request to a file, the added portion is linked to the file, the 
directory entry for the file is updated to acknowledge the added portion, 
and the File Information Block (FIB) is released to free core. After 
the close request has been completed, control is returned to the user 
at the instruction following the assembly language expansion; the argu- 
ment is removed from the stack. As with OPEN, some appropriate device 
action may still be in progress at this point. 

Rules : The dataset to be closed must have previously been 

opened if it was a file on a directory device. 

As with .OPENx, a .CLOSE is not required if the data- 
set is not a file, but it is strongly recommended. 

Errors : Dataset Not Inited - Fatal Error F000; Device Parity 

Error - Fatal Error F017. 


Example : Open for input a dataset named IMP, which is a file 

PR0G1.BIN on DECtape unit 3. After the data transfer is complete, close 
the file. 

. INIT SETl 


. OPENI SETl , FILEl ;OPEN SETl FOR INPUT 

(Input is performed here) 

(continued on next page) 
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.CLOSE SETl , FILEl 


; CLOSE SETl 


. RLSE SETl 

.WORD ERR1 
SETl: .WORD 0 

. RAD 50 /IMP/ 
.BYTE 1,3 
. RAD50 /DT/ 

.WORD ERF1 
.WORD 0 

FILEl: . RAD50 /PRO/ 

. RAD50 /Gl/ 

.RAD 50 /BIN/ 
.BYTE PROG, PRO J 
.BYTE 177 


ADDR OF ERROR RTN 
MONITOR PUTS HOW-OPEN HERE 
FILE NAME 

EXTENSION 
USER ID CODE 
PROTECT CODE 


2. 6.1. 5 .READ 
Read from device. 


Macro Call: . READ LNKBLK , BUFHDR 

where LNKBLK is the address of the link block, and BUFHDR is the address 
of the line buffer header. 

Assembly Language 
Expansion: 

MOV #BUFHDR , - { SP ) 

MOV # LNKBLK,- (SP) 

EMT 4 

Global Name: RWN . 

Description : The .READ request transfers the data specified in 

the line buffer header from the device to his line buffer. The trans- 
fer is done via a buffer in the Monitor, into which an entire device 
block is read, and from which the desired data is transferred to the 
user's line buffer. (If the data requested traverses a device block 
boundary, then a second device block is read.) After any I/O transfer 
has been started, control is returned to the user at the next instruc- 
tion, with the arguments removed from the stack. 

Rules : If the device is file structured, the .READ request 

must be preceded by an .OPENI. 
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The user must provide in his program a line buffer 
and line buffer header (see Figure 2-8) . 

Further actions on the dataset by the Monitor will be 
automatically postponed until the .READ processing has completed. The 
user program should, however, perform a .WAIT or .WAITR to ensure proper 
completion of transfer before attempting to use the data in the line buf- 
fer. 

Errors : Specification of a transfer mode which is inapprop- 

riate for the device assigned to the dataset, and attempting to .READ 
from a .WRITE to a file-structured device for which no file has been 
.OPENed or the type of. OPEN is incorrect. These will be treated as 
fatal and will result in a F010 message. 

Example : (See .WRITE. ) 

2. 6. 1.6 .WRITE 
Write on a device. 

Macro Call: .WRITE LNKBLK , BUFHDR 

where LNKBLK is the address of the link block, and BUFHDR is the address 
of the line buffer header. 

Assembly Language 
Expansion : 

MOV #BUFHDR, - (SP ) 

MOV # LNKBLK,- (SP) 

EMT 2 

Global Name: RWN. 

Description : The .WRITE request initiates the transfer of data 

from the user's line buffer to the device assigned. The data is first 
transferred to a buffer in the Monitor, where it is accumulated until a 
buffer of suitable length for the device is filled. The data in the 
Monitor buffer is then transferred to the appropriate device block, and 
any data remaining in the user's line buffer is moved to the (emptied) 
Monitor buffer. After any I/O transfer to the device has been started, 
control is returned to the user at the next sequential instruction. 

The arguments are removed from the stack upon return. 
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Rules : 


If the requested device is file structured, the data- 
set must have been opened by an .OPENO or .OPENE for a linked file, or 
.OPENC for a contiguous file. 

The user must provide a line buffer and its header 
in his program (Figure 2-8) . 

Further actions on the dataset by the Monitor after 
.WRITE will be automatically postponed until the .WRITE processing has 
been completed. Before refilling the line buffer, however, the user 
program should perform a .WAIT or .WAITR to insure proper completion of 
the transfer. 

Errors : See .READ for errors. 


2. 6. 1.7 .WAIT 

Wait for completion of process on dataset. 

Macro Call: .WAIT LNKBLK 

where LNKBLK is the address of the link block. 

Assembly Language 
Expansion : 

MOV # LNKBLK , - ( SP ) 

EMT 1 

Global Name: (Routine is permanently core resident.) 

Description : .WAIT tests for completion of the last requested ac- 

tion on the dataset represented by the referenced link block. If the 
action is complete, (that is, if the request has completed all its ac- 
tion) , control is returned to the user at the next sequential instruc- 
tion following the assembly language expansion. Otherwise, the Monitor 
retains control until the action is complete. A .WAIT or .WAITR should 
be used to ensure the integrity of data transferred to or from a line 
buffer. The argument is removed from the stack. 

Rules : The dataset must be inited. 

Errors : If the dataset is not inited, a fatal error occurs 

and F000 is printed to the teleprinter. 


2-24 



2.6.1.S 


. WAITR 


Wait for completion of processing on dataset, then return. 

Macro Call: .WAITR LNKBLK, ADDR 

where LNKBLK is the address of the link block, and ADDR is the address 
to which control is transferred if the processing is not complete. 

Assembly Language 
Expansion : 

MOV #ADDR, - (SP) 

MOV #LNKBLK,- (SP) 

EMT 0 

Global Name: (Permanently Core Resident. ) 


Description: .WAITR tests for completion of the last requested 

action on the specified dataset. If all actions are completed, control 
is transferred back to the user at the next sequential instruction fol- 
lowing the assembly language expansion. If all actions are not complete, 
control is given to the instruction at location ADDR. The arguments are 
removed from the stack. It is the user's responsibility to return to 
the .WAITR to check again. 

Rules: The user should use a .WAIT or a .WAITR request to 

assure the completion of data transfer to the user line buffer before 
processing the data in the buffer, or moving data into it. The dataset 
must be inited. 

Errors: If the dataset is not Inited, this is a fatal error, 

and the message FOOO is printed on the teleprxnter ^ 

2.6.2 BLOCK Level Requests 

BLOCK requests provide for the random access to the blocks of files 
stored on the disk or DECtape. In this mode, data is transmitted to or 
from a specified block in a file with no formatting performed. Trans- 
fers take place between the device block and the Monitor buffer. The 
user is responsible for transferring the block to and from his own area. 
BLOCK level requests require the use of the . INIT, .RLSE, .OPEN and 
.CLOSE requests discussed earlier. 

2 . 6 . 2 . 1 .BLOC K 

Transfer one block of a file. 
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Macro Call: 


.BLOCK LNKBLK , BLKBLK 
where LNKBLK is the address of the link block , and BLKBLK is the ad- 
dress of the BLOCK block (see Figure 2-11) . 

Assembly Language 

Expansion: MOV # BLKBLK, - (SP) 

MOV # LNKBLK,- (SP) 

EMT 11 

Global Name: BLO. (See Appendix C for subsidiary routines.) 

Description: This request allows for random, relative block ac- 

cess to contiguous files. The user must specify one of three functions 
in the block called: INPUT, GET, and OUTPUT. After the transfer has 
started, control is returned to the user at the instruction following 
the assembly language expansion with arguments removed from the stack. 

INPUT: During an INPUT request, the requested block of 

the requested file is read into a Monitor buffer, and the user is giv- 
en in the BLOCK block (see Figure 2-11) the address of the buffer and 
the physical length of the block transferred. 

GET: During a GET request the Monitor gives the user the 

address and Length of a buffer within the Monitor that he can fill for 
subsequent output. The user must be careful that he does not over-run 
the buffer. 

OUTPUT: During an OUTPUT request, the buffer assigned is 

written on the device in the requested relative position of the re- 
quested file. 


Rules: The associated file must be opened by .OPENI for 

input or .OPENU for input or output. 

Access to linked files or non-directory devices is 


illegal . 


The user must set up the BLOCK block in his program 
according to the format of Figure 2-11. 


Errors : Error processing causes a return to the user as 

usual, with the type of error indicated in the FUNCTION/STATUS word 
of the BLOCK block. The user should perform 


TSTB BLKBLK+1 
BNE ERROR 
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after a .WAIT to ensure that his request was error free. 


r PT5fl'M T otto H 


TRAN requests provide for random access to any device. Bulk storage 
or directory devices are accessed by absolute block without regard to 
the directory structure. For this reason, the user should be very care- 
ful not to destroy the file structure of a directory device to which 
he is requesting TRAN level transfers. Data is transferred directly 
between the device and the user line buffer. No formatting is performed. 


TRAN requests require the use of the . INIT and .RLSE requests, 
discussed earlier. 


2. 6. 3. 1 .TRAN 
Transfer absolute block. 


Macro Call: .TRAN LNKBLK , TRNBLK 

where LNKBLK is the address of the link block, and TRNBLK is the address 
of the TRAN block. 

Assembly Language 
Expansion : 

MOV #TRNBLK, - (SP) 

MOV #LNKBLK,- (SP) 

EMT 10 

Global Name : TRA. 

Description : .TRAN performs a direct transfer of data, by absolute 

block on the device, between the device and the user's area in core 
memory. No Monitor buffering or formatting occurs. After the transfer 
has started, control is returned to the user at the instruction follow- 
ing the assembly language expansion. The arguments are removed from 
the stack. The user is warned that .TRAN provides no protection for 
files on a directory-oriented device. 

Rules : .TRAN must be preceded by an .INIT request on the 

associated dataset. 


For each .TRAN request, the user must provide a 
transfer control block, as shown in Figure 2-12. 
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Further actions on the dataset by the Monitor will 
be automatically postponed until the .TRAN processing has been completed. 
The user program should perform a .WAIT or . WAITR to ensure proper com- 
pletion of the transfer before attempting to reference any location in 
the data buffer. 


If file structured data shares the same device as 
the block (s) referenced by the .TRAN request, it is recommended that 
the user first allocate a contiguous file for .TRAN usage. 

Errors : An invalid function code in the transfer control 

block will result in an error diagnostic message on the teleprinter at 
run time. 


Errors in the transfer will be shown in the function/ 
status word of the TRAN block; the last word of the block will be set 
to show how many data words have not been actioned. 


Example : Transfer 200 g words of data from DECtape Unit 3, 

starting at block 100g to core starting at location 4000 Q . 


. INIT TAPE1 

.TRAN TAPE 1,BIN40 

, RLSE TAPE 1 
.WORD ERR 1 
TAPE 1: .WORD 0 

. RAD 50 /TP1/ 

-BYTE 1,3 
. RAD 5,0 /DT/ 

BIN40: .WORD 100 

.WORD 4000 
•WORD 200 
.WORD 4 
.WORD 0 


; STARTING BLOCK # 

; STARTING ADDRESS IN CORE 
; NUMBER OF WORDS 
; INPUT 

? FOR MONITOR USE 


2.6.4 Requests for Input/Output Related Services 
2. 6. 4.1 .SPEC 
Special functions. 


Macro Call: .SPEC LNKBLK , CODE 

where LNKBLK is the address of the link block, and CODE is the special 
function code. 
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Assembly Language 
Exoansion: 

" MOV #CODE , - (SP ) 

MOV #LNKBLK f - (SP) 

EMT 12 

Global Name: SPC . 

Description : This request is used to specify a special function 

action to a device, such as rewind magnetic tape- The code identifies 
the special function. Available codes are listed below. If a SPEC 
request is made to a device which has no special function, then an im- 
mediate return is made showing that the function has been completed. 
After the request has been started, control is returned to the user at 
the instruction following the assembly language expansion. The stack 

Rules : The dataset must be inited. 

Errors : Fatal Error F000 is returned if the dataset has not 

been inited. 

2. 6. 4. 2 .STAT 
Obtain device status. 

Macro Call; . STAT LNKBLK 

where LNKBLK is the address of the link block. 

Assembly Language 
Expansion ; 

MOV # LNKBLK, - (SP) 

EMT 13 

Global Name: STT. 

Description: Determine for the user the characteristics of the 

device specified in the link block. After the request has been com- 
pleted, control is returned to the user at the instruction following 
the assembly language expansion. This request returns to the user with 
the following information at the top of the stack: 


SP 

Driver Facilities Word 

SP+2 

Device Name 

SP+4 

Device Standard Buffer Size 
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where DRIVER FACILITIES WORD has the following format: 

DEVICE NAME is the Radix -50 packed ASCII standard 
mnemonic for the device (Appendix A) . 

Device Standard BUFFER SIZE is the block size on a 
blocked device or an appropriate grouping size on a character device. 

_ i, The dataset must be inited. The user must clear the 

stack upon return. 


15 

/ 

14 

V 

13 

12 

D 

10 

9 

8 

/ 

D 

6 

y - J 

5 

4 

3 

2 

0 

1 


spares 

1 ^device is 
directory 
structured, 

Issdevice is DEC tape 
l=device is a terminal- 
l*driver has an OPEN entry - 
l*driver has a CLOSE entry - 
ls=driver has a special function entry 


Issdevice will support multi- 
dataset activity 

L l=device will handle output 

Issdevice will handle input 

lsdevice will handle 
binary data 

Issdevice will handle 
ASCII data 


2.7 DEFINITIONS OF REQUESTS OF DIRECTORY MANAGEMENT SERVICES 
2.7.1 .ALLOC 

Allocate (create a contiguous file) . 

Macro Call : .ALLOC LNKBLK , FILBLK , N 

where LNKBLK is the address of the link block, FILBLK is the address 
of the filename block, and N is the number of 64-word segments re- 
quested. 

Assembly Language 
Expansion : 

MOV #N, - (SP) 

MOV #FILBLK,- (SP) 

MOV #FLKBLK, - (SP) 

EMT 15 
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Global Name: 


ALO . 


(See Appendix C for subsidiary routines.) 


Description : Searches the device for a free area equal to N 64- 

word segments, and creates a contiguous file in the area if it is found, 

by making an appropriate entry in the User File Directory. (Linked 

files are created by an .OPENO request.) Search begins at the high 

end of the device. The number of blocks allocated will be the minimum 

number required to satisfy N segments, i.e., 

N 

B 

where B is the number of segments per block. For example, if N=9 for 
DECtape,' and 

B = = 4 therefore, 



After the request has been completed, control is returned to the user 
at the instruction following the assembly language expansion. The 
segments are removed from the stack. 


Rules : Must be preceded by an . INIT request on the dataset. 

A filename block must be set up by the user in his program. 


Errors : Control is returned either to the ERROR RETURN 

ADDRESS in the filename block if it is specified, or to the console 
for an error message if it is not. Possible errors resulting from 
.ALLOC are: 


Error Code Returned Error Message 
Error Condition To Filename Block On Default 


Dataset Not Inited 
Device Not Ready 

File Exists — - 

Illegal File Name 
UIC Not In Directory 
Directory Full 


None 

F000 

None 

A002 

2 

F024 

15 

F024 

13 

F024 

12 

F024 


Example : Create a contiguous file of length 1024 -^q words on 

DECtape unit 4. Name the file FREQ . DAT . 


.ALLOC FRQ,FREQIN, 20 


.WORD ERRl 

FRQ: .WORD 0 

.RAD 50 /DTA/ 
.BYTE 1,4 
.RAD50 /DT/ 


(continued on next page) 
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(continued from preceding page) 


.WORD ERR2 

FREQUIN: .RAD 50 /FRE/ 

.RAD50 /Q/ 

.RAD 50 /DAT/ 

.WORD UIC , PROTl 

ERRl : 

ERR2: 

2.7.2 .DELET 
Delete a file. 

Macro Call : .DELET LNKBLK, FILBLK 

where LNKBLK is address of link block, and FILBLK is address of file- 
name block. 

Assembly Language 

MOV #FILBLK, - (SP) 

MOV # LNKBLK,- (SP) 

EMT 21 

DEL. (See Appendix C for subsidiary routines.) 


Deletes from directory oriented device the file 
named in the filename block. After the request has been completed, 
control is returned to the user at the instruction following the assem- 
bly language expansion. The arguments are removed from the stack. 

Rules : .DELET operates on both contiguous and linked files. 

If the file has been opened, it must be closed before it is deleted. 

Errors ; Control is returned either to the error return 

address in the filename block if it is specified, or to the console 
for an error message if it is not. Possible errors resulting from 
.DELET are: 


Expansion : 

Global Name : 

Description : 


TO HERE IF NO BUFFER AVAILABLE 
FOR DRIVER 

TO HERE IF NOT ENOUGH CONTIGUOUS 
BLOCKS ON DEVICE 
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Error Code Returned 
Error Condition To Filename Block 

Error Message 
On Default 

Dataset Not Inited 

None 

F000 

Device Not Ready 

None 

A002 

Non-existent File 

2 

F024 

Protect Code Violate 

6 

F024 

File Is Open 

14 

F024 


2 . 1.3 . RENAM 

Rename a file. 

Macro Call : .RENAM LNKBLK , OLDNAM , NEWNAM 

where LNKBLK is the address of the link block, OLDNAM is the address 
of the filename block representing the file, and NEWNAM is the address 
of the filename block containing the new information. 


Assembly Language 
Expansion: 

MOV #NEWNAM, - (SP) 
MOV #OLDNAM,- (SP) 
MOV # LNKBLK,- (SP) 
EMT 20 


m AT — . -rvv ^ . 


REN. 


/ C ^ ^ A 


i4- T 


mes . ) 


Description : Allows the user to change the name and protection 

code of a file. After the request has been completed, control is re- 
turned to the user at the instruction following the assembly language 
expansion. The arguments are removed from the stack. 


Rules: Dataset must be Inited, and file must not be opened. 

The user must specify two filename blocks; one contains the name and 
protection code of the file as it presently is before the .RENAM re- 
quest, and the other contains the name and protection code of the file 
as it should be after the .RENAM request. The two file names must be 
different. To change just the protection for a file, two .RENAMs 
must be requested. 

The user must be authorized to access the file. 

The new file name must not already exist, and the new file name must 
be legal. 

The old file must exist. 
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Errors : Control is returned either to the error return ad- 

dress in the offending filename block if it is specified and applicable, 
or to the Monitor for an error message if it is not. Possible errors 
resulting from .RENAM are: 


ERROR CODE 

RETURNED TO ERROR MESSAGE 

ERROR CONDITION FILENAME BLOCK ON DEFAULT 


File Exists (New Name) 2 F024 
File Does Not Exist (Old File) 2 F024 
Dataset Not Inited None F000 
File Is Open 14 F024 
Protection Violation 6 F024 
Illegal File Name 15 F024 


2.7.4 .APPEND 


Append one linked file onto another. 


Macro Call: .APPEND LNKBLK, FIRST, SECOND 

where LNKBLK is the address of the link block, FIRST is the address of 
the filename block for the first file, and SECOND is the address of the 
filename block for the second file. 


Assembly Language 
Expansion : 

MOV # SECOND, - (SP) 
MOV #FIRST , - ( SP ) 
MOV # LNKBLK,- (SP) 
EMT 2 


Global Name : 


APP (see Appendix C for subsidiary routines.) 


Description : Makes one linked file out of two by appending the 

SECOND to the FIRST. The directory entry of the SECOND file is deleted. 
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When the request is completed/ control is returned to the user at the 
instruction following the assembly language expansion. The arguments 
are removed from the stack. No attempt is made to pack the two files 
together, the physical blocks are merely linked together. 

Errors . Control is returned either to the error return ad— 

dress in the offending filename block if it is specified, or to the 
console for an error message if it is not. Possible errors resulting 
from .APPEND are: 


ERROR CODE 
RETURNED TO 

ERROR CONDITION FILENAME BLOCK 


Dataset Not Inited None 

FIRST FILE NONEXISTENT 2 

CONTIGUOUS FILE 5 

Device Not Ready None 

Protect Code Violated 6 

File Opened 14 


ERROR MESSAGE 
ON DEFAULT 


F000 

F024 

F024 

A002 


F024 


F024 


2 . 1.5 .LOOK 

Searches the directory for a particular filename. 

Macro Call: . LOOK LNKBLK , FILBLK 

where LNKBLK is the address of the link block, and FILBLK is the address 
of the filename block. 



MOV fFILBLK , - (SP) 
MOV # LNKBLK,- (SP) 
EMT 14 


Globa l Name: DIR. (See Appendix C for subsidiary routines.) 

Description: The primary purpose of this routine is to search 

through a specified directory for a specified file and return with the 
current parameters of the file. However, this routine will also be used 
to return the characteristics of a non-directory device. 

The device searched is specified through the link block, 
and the file through the filename block. The request returns to the user 
with the top two elements of the stack as follows - 
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SP 


Length 

Indicator Word 


SP+2 


where Length is the number of blocks in the file in binary, and the 

Indicator Word is encoded as follows: 

bit 0=1 . . . OPENC allowed 

bit 1=1 . . . OPENI allowed 

bit 2=1 . . . OPENE allowed 

bit 3=1 . . . OPENU allowed 

bit 4=0 . . . file is closed 

=1 ... file is open 

bit 5 is 0 

bit 6=0 . . . file is linked 

=1 ... file is contiguous 

bit 7=0 ... file does not exist (OPENO allowed) 

=1 ... file exists 

bits 15-8 ... protection code 

After the request has been completed, control is re 
turned to the user at the instruction following the assembly language 
expansion. The stack must be cleared by the user. 


Rules : The dataset must be Ini ted. 

Errors : Control is returned either to the error return ad - 

dress in the filename block if it is specified, or to the console for 
an error message if it is not. Possible errors resulting from .LOOK 
are : 


ERROR CONDITION 

ERROR CODE 

RETURNED TO 

FILENAME BLOCK 

ERROR M! 

Dataset Not Inited 

None 

F000 

Device Not Ready 

None 

A002 

File Is Open 

14 

F024 

Illegal File Name 

15 

F024 


2.7.6 .KEEP 

Protect file from automatic deletion. 

Macro Call: .KEEP LNKBLK, FILBLK 

where FILBLK is the address of the filename block of the file to be pro 
tected. 


Assembly Language 

E xpansion : MOV #FILBLK, - (SP) 

MOV #LNKBLK,- (SP) 
EMT 24 


Global Name: 


PRO. 
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Description : Protects the named file from being deleted by the 

monitor upon a Finish command (Section 2. 3. 5. 5). It does this by set- 
ting bit 7 of the PROTECT byte in the filename block. 

2. 8 DEFINITION OF REQUESTS FOR MISCELLANEOUS SERVICES 

2.8.1 Requests to Return Control to the Monitor 

2. 8. 1.1 .EXIT 

Exit from program to Monitor. 

Macro Call: .EXIT 

Assembly Language 
Expansion : EMT 6 0 

Global Name: XI T. 

Description: This is the last executed statement of a user's pro- 

gram. It returns control to the Monitor, insures that all of the pro- 
gram's data files have been closed and, in general, prepares for the 
next keyboard request. After the exit, all Monitor buffer space reserve 
for the program, such as Device Assignment Tables (DAT) , are returned to 
free core. 

2.8.2 Requests to Set Monitor Parameters 

In addition to the above programmed requests, the user has some utility 
and conversion routines which he accesses via the EMT levels 41 and 42 
instruction. The user communicates his request to the monitor by push- 
ing the necessary parameters and an identifier code onto the stack. 

2. 8. 2.1 .TRAP 

Sets interrupt vector for the trap instruction. 

Macro Call: .TRAP STATUS, ADDR 

where ADDR is the address for trap, STATUS is the desired status for 
the trap. 

Assembly Langua ge 
Expansion : 

MOV #ADDR, - ( SP ) 

MOV #STATUS,- (SP) 

MOV #1,-(SP) 

EMT 41 
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Global Name: 


GUT. 


Description: Sets the STATUS and ADDR into trap vector 34. Con- 

trol is returned to the user at the instruction following the assembly 
language expansion, after the request is completed. The stack is cleared. 
The user may then use the TRAP instruction. 

2. 8.2.2 . RSTRT 

Sets address used by the restart command. 

Macro Call: . RSTRT ADDR 

where ADDR is the restart address. 

Assembly Language 
Expansion: 

MOV #ADDR,-(SP) 

MOV #2,- (SP) 

EMT 41 

Global Name : GUT. 

Description: Sets the address where the program should restart in 

response to the keyboard command REstart. This is the default address 
in the absence of an address in the REstart operator command. After the 
request is completed, control is returned to the user at the instruction 
following the assembly language expansion. The stack is cleared. 

2.8.3 Requests to Obtain Monitor Parameters 
2. 8. 3.1 .CORE 

Obtains address of the highest word in core memory. 

Macro Call: .CORE 


Assembly Language 
Expansion: 

MOV #100 ,i- (SP) ; CODE 

EMT 41 


Global Name: GUT. 


Description: Determines the address of the highest word in core 

memory (core size minus 2) and returns it to the top of the stack. For 
an 8K machine, it would return 37776. The user must clear the stack. 
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2 . 8 . 3. 2 


. MONR 


Obtains the address of the first word above the Monitor* 

Macro Call: .MONR 


Assembly Language 
Expansion : 

MOV #101,-- (SP) 
EMT 41 


Global Name: GUT . 


Description : Determines the first word above the top of the cur- 

rently resident Monitor (see Figure 2-4) and returns it to the user at 
the top of the stack. Control is returned to the user at the instruction 
following the assembly language expansion after the request is completed. 
The user must clear the stack. 

2. 8. 3. 3 .MONF 

Obtain the address of the first word above the Monitor's highest allo- 
cated free core buffer. 

Macro Call: . MONF 

Assembly Language 
Expansion : 

MOV #102,- (SP) 

EMT 41 

Global Name: GUT . 

Description : The address of the first word above total Monitor area 

(see Figure 2-4) including the buffer and transient areas current at the 
time of the request, is returned to the user at the top of the stack. 
After the request is completed, control is returned to the user at the in- 
struction following the assembly language expansion. 

The user must clear the stack. 

Rules : Since buffers are allocated by the Monitor in its 

processing of certain requests, .MONF should be placed in the program 
at the point where the information is actually required. 
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For Program Duration 
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Generated Before Load Time 


Permanently Resident Monitor 
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Programs 


«-Top of Full 
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Top of Resident 
Monitor 


and Full Monitor 




2.S.3.4 


DATE 


Obtain date. 

Macro Call: .DATE 


Assembly Language 
Expansion : 

»»r\T7 JIT r\ 

huv fiuo f ; 

EMT 41 

Global Name: GUT . 

Description : The current date word is returned to the user at the 

top of the stack. The user must clear the stack. The date format is 

Julian- 70 , 000, « . 

xu 

2. 8. 3. 5 .TIME 
Obtain time of day. 

Macro Call: .TIME 


Assembly Language 
Expansion : 

Turr\\7 1L 1 A / r*T\\ 

v'ikj v 

EMT 41 

Global Name: GUT. 

Description : The two current time words are returned to the user 

at the top of the stack. 

PC 

PC+2 

where a TIC is 1/60 of a second (1/50 second for 50 cycle lines) . The 
words are 15-bit unsigned numbers. The user must clear the stack. 

2. 8. 3. 6 . GTUIC 

Get current UIC. 

Macro Call: .GTUIC 


LOW ORDER TIME IN TICS 
HIGH ORDER TIME 
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Assembly Language 
Expansion : 


; CODE 


MOV #105, -(SP) 

EMT 41 

Global Name ; GUT. 

Description: The current user’s UIC is returned to the user at the 

top of the stack. The user must clear the stack. 

2.8.4. Requests to Perform Conversions 
2. 8. 4.1 . RADPK 

Pack three ASCII characters into one RADIX-50 word. 

Macro Call: .RADPK ADDR 

where ADDR is the address of the first byte in the 3-byte string of 
ASCII characters to be converted. 

Assembly Language 
Expansion: 

MOV #ADDR, - (SP) 

MOV #0,-(SP) ;MOVE CALL CODE ONTO STACK 

EMT 42 

Global Name: CVT. 

Description: The string of 7 or 8-bit ASCII characters in three 

consecutive bytes starting at ADDR is converted to RADIX-50 packed ASCII 
using the algorithm in Appendix D. The packed value is returned on the 
top of the stack, followed by the address of the byte following the last 
character converted. 

Rules : ADDR may be set at any byte address (need not be at 

word boundary) . 


The stack must be cleared by the user after the Moni- 
tor returns control. 

Errors : The conversion will be stopped if an error condition 

is encountered, and the user will be informed of the type of error via 
the condition codes in the Processor Status register: 

N— bit set means an illegal call code (greater than 

5) was used. 
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C-bit set means that an ASCII byte was used which 
was outside the valid RADIX-50 set. (See Appendix D.) 


In the latter case, the returned value will be left- 
justified and correct up to the last valid byte. The address returned 
will be that of the first invalid byte. No conversion will follow re- 
cognition of an N error. 


If there were no errors encountered during the con- 
version, the condition codes will be cleared, e.g.,- DT:=DT : 


Example 


Pack a string of 30 ^q ASCII characters, starting at 


into 

a buffer starting 

at PAKBUF. 


MOV 

#PAKBUF,R3 

; SET UP POINTER TO 

PACK-BUFFER 

MOV 

#UNPBUF,- (SP) 

; . RADPK UNBUF 


MOV 

#j0,-(sp) 



EMT 

42 



BCS 

ERRC 

; INVLID ASCII CODE 

ENCOUNTERED 

MOV 

(SP)+, (R3)+ 

;MOV PACKED VALUE 

TO BUFFER 

CMP 

R3, #PAKBUF+12 

; END OF STRING? 


BNE 

NEXT 

;N0 


TST 

(SP) + 

; YES — REMOVE POINTER FROM STACK 


Note that this example takes advantage of the fact 
that the Monitor returns to the stack the address of the byte which fol- 
lows the last character converted. 


2. 8. 4. 2 .RAD UP 

Unpack one RADIX-50 word into three ASCII characters. 


Macro call; .RADUP ADD R, WORD 

where ADDR is the pointer to the buffer into which the unpacked bytes 


Assembly Language 
Expansion : 

MOV # WORD, -(SP) 

MOV #ADDR , - ( SP ) 

MOV #1,-(SP) ; MOVE CALL CODE ONTO STACK 

EMT 4 2 


Global Name: CVT. 


Description: WORD is converted into a string of 7-bit ASCII charac- 

ters which are placed left- justified with trailing spaces in three con- 
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secutive bytes starting at location ADDR. The stack is returned cleared 


Errors : The conversion will be stopped if an error condition 

is encountered. The user will be informed of the type of error via the 
condition codes in the Processor Status register: 

N-bit set means a call code greater than 5 was used. 
No conversion has been attempted as a result. 

C-bit set means that (a) a value of WORD was outside 
the valid RADIX-50 set, i.e. , 174777, (see Appendix D) ; (b) a RADIX-50 

byte value was found to be 35, which is currently not used. 

Nevertheless, three bytes will be returned, with a 
: as the first of the three for error type (a) , and any of the three 
a / for error type (b) . 

If the conversion is satisfactory, the condition 

codes are cleared. 

2. 8. 4. 3 . D2BIN 

Convert five decimal ASCII characters into one binary word. 

Macro Call: . D2BIN ADDR 

where ADDR is the address of the first byte in the 5-byte string of 
decimal characters to be converted (can be on byte- or word-boundary) . 

Assembly Language 
Expansion : 

MOV #ADDR, - (SP) 

MOV #2 ,- (SP) ;MOVE CALL CODE ONTO STACK 

EMT 42 

Global Name : CVT. 

Description : The 5-byte string of 7- or 8-bit ASCII characters 

which start at ADDR are converted into their binary equivalent. The con 
verted value is returned to the top of the stack, right justified, fol- 
lowed by the address of the byte which follows the last character con- 
verted. The largest decimal number that can be converted is 65,535 
16 

(2 -1) . The user must clear the stack. 

Errors : The conversion will be stopped if an error condition 
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is encountered. The user will be informed of the type of error via the 
condition codes in the Processor Status register. 

N-bit set means a call code greater than 5 was used 
(no conversion) . C-bit set means that a byte was not a digit. V-bit 
set means that the decimal number was too large. 

The returned value will be correct up to the last 
valid byte. The address returned will be that of the invalid byte. If 
the conversion is satisfactory, the condition codes will be cleared. 

2. 8. 4. 4 . BIN2D 

Convert one binary word to five decimal ASCII characters. 

Macro Call: . BIN2D ADDR,WORD 

where WORD is the number to be converted, and ADDR is’ the address of 
the buffer where the characters are to be placed. 

Assembly Language 
Expansion : 

MOV #WORD,-(SP) 

MOV #ADDR , - ( SP) 

MOV #3 (SP) ;MOVE CALL CODE ONTO STACK 

EMT 42 

Global Name: CVT. 

Description : WORD is converted into a string of five decimal 

7-bit ASCII characters which are placed into consecutive bytes starting 
at location ADDR. They are right justified with leading zeros. The 
stack is cleared. 


Errors : The conversion will be stopped if an error condition 

is encountered. The user will be informed of the type of error via the 
condition codes in the processor status register: 

N-bit set means a call code greater than 5 was used. 
If the conversion was satisfactory, the condition 

codes are cleared. 

2. 8. 4. 5 . 02BIN 

Convert six octal ASCII characters to one binary word. 



Macro Call: 


. 02BIN ADDR 


where ADDR is the address of the first byte in the 6-byte string of oc- 
tal characters to be converted. 

Assembly Language 
Expansion : 

MOV #ADDR, - (SP) 

MOV #4 , - (SP) ? MOVE CALL CODE ONTO STACK 

EMT 42 

Global Name: CVT, 

Description: The 6-byte string of octal 7- or 8-bit ASCII charac- 

ters which start at ADDR are converted into the binary number equivalent 
The converted value is returned to the top of the stack, right justified 
followed by the address of the byte which follows the last character 
converted. The largest octal number which can be converted is 177777. 
The stack must be cleared by the user. 

Errors : The conversion will be stopped if an error condition 

is encountered, and the user will be informed of the type of error via 
era condition codes in the Processor Status register. 

N-bit set means that a call code greater than 5 was 
used. C-bit sez means that a byte was not a digit. V-bit set means 
that the octal number was too large, i.e. , the first byte of six was 
greater tnan 1. 


If the conversion has been satisfactory, the condi- 
tion codes are cleared, in either case, the returned value will be cor- 
rect up to the last valid byte. The returned address will be that of 
the first invalid byte. 

2 . 9 . 4 . 6 . BIN20 

Convert one binary word to six octal ASCII characters. 

Macro Call: .BIN20 ADDR, WORD 

where WORD is the binary number to be converted, and ADDR is the address 
of the buffer into which the six octal ASCII characters are to be placed 

Assembly Language 

Expansion : 

MOV #WORD , - (SP) 

MOV #ADDR , - (SP) 

MOV #5, - (SP) 

EMT 42 
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Global Name : 


CVT . 


Description : The WORD is converted into a 6-byte string of octal 

7-bit ASCII characters/ right justified with leading zeros, which are 
placed into the buffer addressed by ADDR. The stack is cleared. 

Errors : The conversion will be stopped if an error condition 

is encountered, and the user will be informed of the type of error via 
the condition codes in the processor status register: 

N-bit set means a call code greater than 5 was used. 

If the conversion was satisfactory, the condition 

codes are cleared. 

2.8.5 Requests for Interfacing to the Command String Interpreter 

A user program may obtain I/O device specifications via keyboard input 
at run time by calling the Command String Interpreter (CSI) Monitor 
routine. This is the same routine used by many system programs; it 
accepts keyboard input at program run time in the format presented in 
Section 3.4.1. 


The CSI is called in two parts, by two different re- 
quests: . CSI 1 and .CSI2. . CSI1 condenses the command string and checks 

for syntactical errors. .CSI 2 sets the appropriate link block and file- 
name block parameters for each dataset specification in the command 
string. Each command string requires one . CSI1 request for the entire 
command string, and one . CSI2 request for each dataset specifier in the 
command string. 


The user must first set up a line buffer in his pro- 
gram and read in the command string. Then he does a . CSI1, which con- 
denses the string by eliminating spaces, horizontal TABs , nulls, and 
RUBOUTs, sets pointers in a table to be referenced by .CSI2, and checks 
the command string for syntactical errors. If there are no errors, the 
.CSI2 request may be given once for each device that the user expects 
to find in the command string. . CSI2 sets up the appropriate link 
block and filename parameter according to the device name, file name, 
extension, UIC, and switch entries in the command string. 

2. 8. 5.1 .CSI1 

Condense command string and check syntax. 
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Format: 


.CSI1 CMDBUF 


where CMDBUF is the address of the command string buffer. 

Assembly Language 
Expansion : 

MOV #CMDBUF , - (SP) 

EMT 56 

Global Name: CSX. 

Description: Collapses the command string by removing spaces, 

horizontal TABs , nulls, and RUBOUTs , and checks the entire command 
string for syntactical errors. Control is returned to the user with a 
0 at the top of the stack if the syntax was acceptable, or with the 
address (in the command string line buffer) of the data byte where the 
scan encountered the first error. 

Rules : The .CSI2 request must be preceded by a .CSI1 re- 

quest, because .CSI2 assumes it is getting a syntactically correct com- 
mand; more than one CSI2 request can follow a single .CSI1 request. 

The user must set up a line buffer and read in the 
command string before doing CSI1. 

It is the user's responsibility to print a # on the 
teleprinter to inform the operator that a CSI format is expected (Sec- 
tion 3.1). 


The user must set up a seven-word command buffer 
header in his program immediately preceding the header of the line buf- 
fer into which the command is to be read. The user is not required at 
this time to set up anything in the command buffer header prior to call- 
ing .CSI1; it will be used as a work-and-communication area by the 
Monitor routines processing the . CSI1 and .CSI2 requests. 

The user must clear the stack upon return from the 
Monitor. If the top of the stack ^ 0, (i.e., if there was a syntax 
error) , then .CSI2 must not be called. 

Example : (See .CSI2.) 

2. 8. 5. 2 . CSI 2 

Interpret one dataset specification of command string. 
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Format: 


. CSI2 CS2BLK 


Assembly Language 
- - -*■ - ■■ 

Expansion : 

MOV #CS2BLK , - ( SP) 
EMT 57 


Global Name: CSM. 


Description : Gets the next input or output dataset specification 

from the command string, and sets the PHYSICAL DEVICE NAME entry in the 
link block, the FILENAME, EXTENSION, and UIC entries in the filename 
block, and any switch entries in an extension of the link block. 

Rules : Before calling .CSI2, the user must: 

• Call CSI 1 to condense the command string and check it for 
syntax errors. There must have been no syntax errors. 

• Set up a CSI control block as follows: 


POINTER 

TO 

CMDBUF 

POINTER 

TO 

LNKBLK 

POINTER 

TO 

FILBLK 


where: POINTER TO CMDBUF is the address of the 7-word buffer preceding 

the command string line buffer header. 

POINTER TO LNKBLK is the address of the link block of the data- 
set whose specification is being requested. 

POI^TTETl TO FILB UK is '^crf fil’STiSTtvs of iihto 

dataset whose specification is being requested (currently, CSI allows 
just one file per dataset specification) . 

• Set the first word of CMDBUF to either 0 or 2. 0 means 

"get next input dataset specification", and 2 means "get the next out- 
put dataset specification". CSI2 does not check the validity of the 
code word. 


• Initialize the NUMBER OF WORDS TO FOLLOW entry in the 

link block to contain the number of words to follow. This must be at 
least one, because CSI2 will alter the following word, i.e., the PHYSICAL 
DEVICE NAME word. CSI2 does not check the validity of this byte. 
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The user may specify any number from 1 to 255 1Q in this location. All 
words in excess of 1 are used for switch space (see the interface with 
respect to switches, described below). 

Upon return from the .CSI2 request, the Monitor will 
have provided the following information: 

• The top of the stack contains either: 

(a) 0, which means the dataset specification requested has 
been obtained, and there are still more dataset specifications of the 
type requested (i.e., input or output); or 

■ (b) 1, which means the dataset specification requested has 
been obtained, and there are no further dataset specifications of the 
type requested; or 

(c) 2, which means (a), but this particular dataset specifica- 
tion included more switches than would fit in the space provided; or 

(d) 3, which means (b) , but this particular dataset specifica- 

included more switches that would fit in the space provided. 

• With respect to the link block (Figure 2-5) : 

(a) If the PHYSICAL DEVICE NAME word is 0, the user does 
not wish this particular output (input) dataset to be generated (read) ; 
i.e., this entry was omitted when the command string was typed in. If 
not zero, the PHYSICAL DEVICE NAME and UNIT NUMBER are appropriately 
s ®t to the device and unit specified in the command string. 

• Immediately following the PHYSICAL DEVICE NAME word in the 
link block are the switches specified in the command string. The in- 
terface for each switch is as follows: 


NUMBER OF WORDS TO FOLLOW 


POINTER TO FIRST CHARACTER OF Vn 


POINTER TO FIRST CHARACTER OF Vn-1 


POINTER TO FIRST CHARACTER OF VI 
W(ASCII) S(ASCII) 
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Assuming this switch was /SWITCH : VI :V2 . . , Vn» If NUM- 


BER OF WORDS TO FOLLOW is 0, there are no more switches. Note that the 
pointers are in reverse order. After the value pointers is a word which 
contains the first two characters of the switch in ASCII. The first 
character is in the low byte, and the second is in the high byte. If 
the name of the switch only contains one character, the ASCII representa- 
tion of that character will be in the low byte, and the high byte will 
contain a zero. Note that if the number of words to follow is not zero, 
it is the number of values +1. 


For example, if the switch /SWITCH; $12 :AB is stored 
in memory beginning at location 1000 as 


1000 

1000 

1002 

1003 

1004 

1005 

1006 

/ 

S 

W 

I 

T 

C 

H 

1007 

1010 

1011 

1012 

1013 

1014 

1015 

: 

$ 

1 

2 

: 

A 

B 

completed 

interface 

appears 

as : 





3 

1014 
1010 
127) 123 

• With respect to the filename block (Figure 2-6) : 

(a) Recall that the FILE NAME occupies the two words at 
FILBLK and FILBLK+2 . If the Monitor returns zero at FILBLK , no FILE 
NAME was specified in the dataset specification. If the Monitor returns 
52 D at FILBLK, * was specified as the FILE NAME. Otherwise, the Monitor 

O 

returns at FILBLK and FILBLK+2 the first six characters of FILE NAME, 
in RADIX- 50 packed ASCII. 

(b) Recall that EXTENSION occupies the word at FILBLK+4. If 
the Monitor returns zero at FILBLK+4, no EXTENSION was specified; if it 
returns 52 0 , then * was specified; otherwise, the Monitor returns the 

O 

first three characters of the extension specified, in RADIX-50 packed 
ASCII. 


(c) Recall that the USER IDENTIFICATION' CODE occupies the 
word at FILBLK+6. If the Monitor returns zero at FILBLK+6, no UIC was 
specified in the dataset specif ication (the I/O processors will assume 
the UIC of this user) . If a UIC was typed in, the Monitor will set this 
word appropriated. The Monitor returns 377g in either high- or low- 
order byte of this word if * was specified. 
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The user may restart at the beginning of the input dataset or output 
dataset side of the command string simply by re-calling .CSI1 and is- 
suing a 0 or 2 code, respectively. Note that he may not restart one 
without restarting the other, unless he saves and restores the approp- 
riate information from CMDBUF . 

Remark : There is no error checking with respect to magni- 

tude when the UNIT or UIC values are converted from octal ASCII to bi- 
nary. 

2. 8. 5. 3 The Link Block 


ERROR RETURN ADDRESS 


000000 LINK POINTER 

(for Monitor use only) 

LOGICAL NAME OF DATASET — Radix-50 Packed ASCII 

UNIT NUMBER 

NUMBER OF WORDS TO FOLLOW 


PHYSICAL DEVICE NAME — Radix-50 Packed ASCII 


Figure 2-5. The Link Block. 


Each dataset in a user's program must have a link 
block associated with it. Entries in the link block which must be speci- 
fied by the user can be written into his program or set by the program 
itself before the dataset is inited. Each entry is explained below. 


ADDRESS 


NAME 


FUNCTION 


LNKBLK-2 


ERROR RETURN ADDRESS 


This entry must be set by the user 
to contain the address where he 
wants control transferred in the 

event that any request which is associated with this dataset fails to 
obtain required buffer space from the Monitor. If no address is speci- 
fxed here, such an error will be treated as fatal. This address may be 
changed by the user's program at any time. 


LNKBLK 


LINK POINTER 


This location must be set to zero 
by the user and must not be modi- 

, . . . _ _ , fied by him. The Monitor places 

a linking address here when the dataset is inited. Before ini ting a 
dataset, the Monitor tests this pointer for zero. If it is not zero 
the Monitor assumes that the dataset was already inited. 

LNKBLK+2 LOGICAL NAME OF DATASET The user can specify a name for the 

dataset in this entry. This is 
. the name that will be used if the 

Assign command is to be called after the program is loaded. If this is 
possible, the name must be unique from that for other datasets. The 
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ADDRESS 


NAME 


FUNCTION 


name is stored in RADIX-50 packed ASCII by the . RAD 50 assembler direc- 
tive . 

LNKBLK+3 NUMBER OF WORDS This byte contains the count of 

TO FOLLOW the number of words to follow in 

the link block. The user should 

set it to a 0 if he does not specify any PHYSICAL DEVICE NAME in the 
next word, or to a 1 if he does. Values greater than 1 may be used 
if the Command String Interpreter is to be called. 


LNKBLK+4 UNIT NUMBER This code specifies the unit num- 

ber of the device linked to the 
dataset. For example, the control 
type TC11 (DECtape) can drive up to eight tape drives (units) , numbered 

0-7. 


LNKBLK+6 PHYSICAL DEVICE NAME If the user specified a 1 at 

LNKBLK+3, he must specify here the 
standard name (Appendix A) for the 

device associated with the dataset. If no name is specified here, the 
user must specify a LOGICAL NAME OF DATASET and perform an ASsign com- 
mand before he runs his program. 

2 . 8 . 5 . 4 The filename Block 



Figure 2-6. The Filename Block, 

Each file associated with a dataset must be 
described by the user in a filename block. If a dataset is not a file, 
the filename block must still be used, but FILE NAME, EXTENSION, and 
PROTECT need not be specified. Each entry is explained below. 


ADDRESS NAME FUNCTION 

FILBLK-4 ERROR RETURN ADDRESS The user must specify here the ad- 

dress to which he wants the Monitor 
to return control if one of the 

errors in Section 2.10 occurs during an operation involving the file. 

If no address is specified here, any such error will be treated as a 
fatal error. 
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TABLE" 2 - 4 . FILENAME BLOCK ERROR CONDITIONS. 


Error Code 
In File- 
name Block 






Faulting 

Request 


. OPENC 
. OPENE 
.OPENI 
. OPENO 
. OPENU 


, OPENO 


, OPENC 
, OPENE 
.OPENI 
, OPENU 


. OPENC 
. OPENE 
.OPENI 
. OPENU 


. OPENC 
, OPENE 
, OPENU 




, OPENC 
, OPENE 
.OPENI 
, OPENO 
. OPENU 






.OPENC 
. OPENE 
. OPENO 
. OPENU 


.ALLOC 
. OPENO 


.ALLOC 
. OPENO 


•APPND 

.DELET 

.RENAM 


.ALLOC 

.OPENO 


An attempt was made to open 
dataset that was previously 
opened. 


unused 


An attempt was made to .OPENO 
a file which already exists. 

An attempt was made to open a 
file for input, extension for 
update which is currently 
opened for output, or which 
does not exist. 


An attempt was made to open 
a file which has already 
been opened the maximum 
number of times (763) . 


An .OPENC, .OPENE, or .OPENU 
attempt was made to open a 
file which has already been 
opened for either .OPENC, 
.OPENE, or .OPENU. 


Illegal request to a con- 
tiguous file. 


An attempt was made to access 
a file which the protection 
code prohibits . 


unused 


Illegal OPEN request to a 
contiguous file. 


File OPENed for output or 
extension is already on 
current DECtape unit. 


Directory full (DT) . 


The UIC was not entered into 
the device MFD. 


An attempt was made to per- 
form an illegal operation on 
an opened file. 


An attempt was made to create 
a file with an illegal file 



Close offending 
file . 


Mount another 
DECtape . 


Enter UIC via 
PIP. 


Wait until file 
is closed. 


Change file name. 



















































ADDRESS 


NAME 


FUNCTION 


FILBLK -2 HOW OPEN This is set when the .OPENx macro 

requests assembly language expan- 
sion is executed. It tells the 

Monitor which kind of open is being requested: .OPENU=l, . OPENO=2, 

. OPENE=3 , . 0PENI=4 , .0PENC=13. 


FILBLK-1 j^kROk CODE This entry should not be set by 

the user. It will be set by the 
Monitor to indicate the type of 

error (Section 2,10) which occurred. 


FILBLK+0 FILE NAME This two-word entry must be speci- 

FILBLK+2 , fied by the user if this dataset, 

or portion thereof, is a file. It 
is the name of the file, in RADIX-50 packed ASCII. 


FILBLR+4 EXTENSION This entry must be specified if the 

file named in the previous entry 
has an extension. It is RADIX-50 packed ASCII. 


FILBLK+10 PROTECT CODE 


If no entry is specified here, 


The user may enter his USER ID CODE 
here in octal : 


GROUP NUMBER 


USER'S NUMBER 


High-Order Byte Low-Order Byte 
the current user's UIC is assumed. 


2. 8. 5. 5 The File Protection Codes 


7 

6 

5 

4 

3 

2 

1 

0 

> 

* a 

— v 





/ 


Owner* Bit 6:1s Owner cannot write on or delete the 

file. This is a safeguard to prevent 
inadvertent deletion or over-writing. 

Bit 7 s 1 = Protect the file from automatic 
deletion on Finish, 

User Group and All Others* 


Function 


Code 

Delete Write Read Run 

0 

yes yes yes yes 

1 

yes yes yes 

2 or 3 

yes yes 

4 or 5 

yes 

6 or 7 



Figure 2-7. File Protection Codes, (continued) 
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Note* 


yes indicates that the operation is allowed# - 
For example, if a file belongs to user L23,10J , 
a protection code of 3 will allow user [12, 4J 
to read or run but not delete or write on it. 


Figure 2-7. File Protection Codes. (concluded) 

2. 8. 5. 6 The Line Buffer Header 


MAXIMUM BYTE COUNT 


STATUS 


MODE 


ACTUAL BYTE COUNT 


POINTER (Dump Mode only) 


Figure 2-8. Line Buffer Header. 


is explained. 


Each element of the Line Buffer Header table 


ADDRESS NAME 


FUNCTION 


BUFHDR MAXIMUM BYTE COUNT The count shows the size of the 

buffer, in bytes. It must be 
specified here by the user on all INPUT operations. 


BUFHDR+1 MODE 

listed and explained in Figure 2-10. 


The user specifies here the mode 
of the transfer. All modes are 


BUFHDR+2 STATUS The Monitor will place in this 

byte the status of the transfer 
when control is returned to the 

user. Figure 2-9 lists each bit and its meaning. Errors encountered 
executing an I/O transfer will be flagged in this byte. The user should 
always check its content after each transfer completes. 


BUFHDR+4 ACTUAL BYTE COUNT This count controls the number of 

bytes to be transferred on OUTPUT. 
It must be initialized by the user before any output transfer from the 
line buffer. After any transfer in or out, it will show how many bytes 
have been transmitted (or in some modes [g.u.] would have been trans- 
ferred had some error not been detected) . 


BUFHDR+6 POINTER (DUMP MODE) If bit 2 of MODE is 1, the user 

specifies here the starting address 
of the line buffer. If bit 2 of MODE is 0, the line buffer header is 
only three words in length, and must immediately precede the line buf- 
fer itself. 
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2. 8. 5. 7 The Status Byte 


7 

6 

5 

4 

3 

2 

1 

0 


0 


End of medium 
(EOM) or 
End of file 
(EOF) 


Device parity 
flag 


V 

A 


L — Invalid line error 

— Checksum error 

Character parity error or 
illegal binary format 


Spare 


Figure 2-9. Status Format. 


The function of each status format bit is explained below. 


BIT 

MODE 

REQUEST 

CONDITION 


ALL 

.READ/WRITE 

Appropriate BYTE COUNT=0 at 
call . 

0 

(INVALID 

LINE) 

FORMATTED 

ASCII NORMAL 
(parity or 
non-parity) 

. READ 

The MAXIMUM BYTE COUNT was 
reached before a line termi- 
nator was seen. (Last byte 

has been overlaid until the 
terminator has been reached. 



•WRITE 

The last byte was not a ter- 
minator . 


FORMATTED 

ASCII SPECIAL 
(parity or 
non-parity) 

.READ 

The MAXIMUM BYTE COUNT was 
reached before a line termi- 
nator was seen (excess data 
has not yet been read) . 



.WRITE 

The ACTUAL BYTE COUNT was 
reached before any termina- 
tor was seen. 
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BIT MODE 


REQUEST 


CONDITION 


FORMATTED BINARY 
NORMAL 


FORMATTED BINARY 
SPECIAL 


1 FORMATTED BINARY 

(CHECK- 
SUM 
ERROR) 


.READ The MAXIMUM BYTE was reached 
before the count stored with 
the data. (The last byte has 
been overlaid in order to veri- 
fy the checksum, ) 

.READ The MAXIMUM BYTE COUNT was 

reached before the count stored 
with the data. (The excess 
data still remains to be read 
and checksum has not been veri- 
fied.) 

.READ There was a discrepancy be- 
tween the checksum accumulated 
during the .READ, and that 
stored with the incoming data. 


2 FORMATTED ASCII 

(PARITY PARITY NORMAL 
FORMAT) OR SPECIAL 


2 FORMATTED BINARY 

(IL- 
LEGAL 
BINARY 
FORMAT) 


•READ A character was read which 
had odd parity. The eighth 
bit of the illegal character 
is delivered set to a 1. 

.READ This bit is set if a line 
processed in a binary mode 
does not have a 001 in the 
first word. 


6 ALL MODES 

(EOM/ 

EOF) 


5 ALL MODES 
(DEVICE 
PARITY) 


.READ An input device cannot supply 

or any more data or an output 

.WRITE device cannot accommodate more, 

i.e. , the disk has no more 
storage space, or the paper 
tape reader has run out of 
paper tape. 


. READ A hardware error has been de- 
or tected on a bulk storage de- 

. WRITE vice. This could be either 

a parity error or a timing 
error. The driver will al- 
ready have tried to READ or 
WRITE 8 or 9 times before 
setting this bit. (This flag 
is intended as a warning that 
the data in this line or some 
subsequent line still using 
data from the same device 
block may be invalid. It will 
be returned for each trans- 
fer call using the same 
block . ) 
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2, S. 5. 8 


The Transfer Modes 



T spares 


Set to 1 to 
suppress automatic 
echo on a terminal 
(keyboard) device. 


t_ 0 - ASCII 
1 = Binary 

0 = Formatted 

1 = Unformatted 


0 = No Operation 

1 = Dump 

Parity 
No Parity 


0 = Normal 

1 s Special 


Figure 2-10. The Mode Byte. 


Formatted ASCII Normal — Data in this mode is assumed by the Moni- 
tor to be in strings of 7-bit ASCII ch aracters terminated by LINE FEED 
FORM FEED , or VERTICAL TAB. 


READ: The line buffer is filled until either a terminator is seen 

or the number of bytes transferred becomes equal to the MAXIMUM BYTE 

COUNT. If the MAXIMUM BYTE COUNT is reached before the terminator is 

seen, the invalid line error bit in the Status Register of the buffer 

header is set, and each remaining character through to the terminator 

is read into the last byte of the line buffer, i.e. , the surplus bytes 

are thrown aw av. affov -t-Ko +- v o -Fo-*- 4-v. e i ~ j_ , .. 

— — j i-j-luiSj-Sj., uiie aui.uai jjyte ijuaiiL tiqucixs tne 

number of bytes read (including the excess). RUBOUTs and NULLs are 

discarded. The terminator is transferred. 


WRITE: The line buffer is output until the number of bytes trans- 

ferred equals the ACTUAL BYTE COUNT. If the last character is not a 
terminator, an invalid line error bit is set in the STATUS BYTE of the 
buffer header. Previous terminators are output as normal characters. 

TABs are followed by RUBOUTs, FORM FEEDs are followed by 

NULLs . 
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The READ/WRITE processor hands the data over to the device 
driver specified, and each driver will convert the information to meet 
its specific needs. Appendix F summarizes the characteristics of the 
drivers . 

2 . Formatted ASCII Special — 

READ: The same as formatted ASCII normal with one exception: if 

the MAXIMUM BYTE COUNT is reached before the terminator, the transfer 
is stopped. The remaining characters are not overlaid, but are retained 
for transfer at the reset .READ. The invalid line error will be re- 
turned in the Status byte and ACTUAL BYTE COUNT will equal MAXIMUM. 

WRITE: The same as formatted ASCII normal with this exception: 

the line buffer is output until the first terminator; the ACTUAL BYTE 
COUNT will stop the transfer if it is reached before the terminator 
is seen. In this case, the invalid line error bit is set into the 
STATUS BYTE. Note that in this mode only one line of data can be out- 
put at once, but its byte count need not be exact, provided this is 
greater than the actual. 

3. Formatted Binary Normal — 

READ: This is an 8-bit transfer. Words 2 and 4, STATUS, MODE, 

and ACTUAL BYTE COUNT always accompany the data during formatted binary 
transfers. The counts are adjusted by the Monitor to include the extra 
words. On input, the line buffer is filled until the number of characters 
transferred equals the ACTUAL BYTE COUNT read, or the MAXIMUM BYTE COUNT. 
If the MAXIMUM is reached before the ACTUAL, an invalid line error oc- 
curs, and the remaining bytes are overlaid into the last byte, until 
the checksum is verified. After the transfer, the ACTUAL BYTE COUNT 
contains the actual number of bytes read (including the excess) . 

WRITE: This is an 8-bit transfer. Words 2 and 4 of the line buf- 

fer are output until the number of characters transferred equal the 
ACTUAL BYTE COUNT and a checksum accumulated. The Checksum is output 
at the end. 

4 . Formatted Binary Special -- 

READ: The line buffer is filled until the number of characters 

transferred equals the ACTUAL BYTE COUNT read. If the MAXIMUM COUNT 
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is reached before the ACTUAL, the remainder of the line is retained by 
the Monitor. The MAXIMUM number is transferred to the line buffer and 
the ACTUAL BYTE COUNT is set to the full input count, rather than the 
number of bytes actually transferred. The invalid line error will be 
set in the Status Byte. The user can compare the MAXIMAL COUNT with 
the ACTUAL, determine how much data remains, and recover it by an un- 
formatted Binary read (allowing 1 extra byte for the checksum) . 

WRITE: Identical to formatted binary normal. 

5. Unformatted ASCII Normal or Special — This mode is available to 
the user who wants to do his own formatting. Seven bits are transferred 
the eighth is always set to zero. NULLs are discarded. 

READ: Transfer stops when the number of bytes transferred reaches 

the MAXIMUM BYTE COUNT. Nulls are discarded but all other characters 
are treated as valid. 


WRITE: All characters are transferred. The transfer stops when 

the ACTUAL BYTE COUNT is reached. 


6. Unformatted Binary Normal or Special — This mode is identical to 
unformatted ASCII except that eight bits are transferred on both input 
and output. No checksum is calculated. 


7. Formatted ASCII Parity — Identical to formatted ASCII (Special or 
Normal) except that even parity is generated in the eighth bit on OUTPUT 
and checked on INPUT. 


8. Unformatted ASCII Parity — Identical to unformatted ASCII (Special 
or Normal) except that eight bits are transferred instead of seven. No 


parity ^snsrsti 


» v* i 

f J_ Uiit 'w 


9. Dump Modes — All modes can be specified as DUMP, which means that 
the word after the ACTUAL BYTE COUNT is considered to be a pointer to 
the beginning of the data rather than the beginning of the data proper. 
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2. 8. 5. 9 The BLOCK Block 


BLKBLK i 


FUNCTION 


BLOCK NUMBER 


MEMORY BUFFER ADDRESS 


LENGTH 


Figure 2-11. The BLOCK Block. 


ADDRESS 


FUNCTION 


BLKBLK 


FUNCTION/STATUS 


User specifies here the function to be 
performed, and the Monitor returns to 
the user with the appropriate status 
bits set. 


Bit = 1 means 


n s 
(3-9) 


function is GET 


function is OUTPUT 


function is INPUT 


spares (ignored by Monitor) 


file is linked, or device 
is not file structured 


block number does not exist 
in file, i.e., it is greater 
than the file length. 


file not open 
protect code violation 


end of data error 


BLKBLK+2 


BLKBLK+4 


BLKBLK +6 


BLOCK NUMBER 


Memory Buffer 
Address 


^15 device parity error 


Requested block number to be transferred 
relative to the beginning of the file. 

First block of file is J2f. 


The address and length of the Monitor 
buffer given by the Monitor on an INPUT 
or GET function. 


Length 


2-62 




2.8.5.10 


The TRAN Block 



Figure 2-12. The TRAN Block. 


The user must set up a TRAN block for each 


•TRAN in his program. 


ADDRESS 


FUNCTION 


TRNBLK 


DEVICE BLOCK 
NUMBER 


TRNBLK+2 MEMORY START 
ADDRESS 


TRNBLK+4 WORD COUNT 


User specifies here the absolute block 
number of the device, at which the trans- 
fer is to begin. If it is not a bulk 
storage device, specify block 0. 


User specifies here the core memory ad- 
dress at which the dataset transfer is 
to begin. 


TRNBLK+6 FUNCTION/STATUS Bit: 


User specifies here the total number of 
16-bit words to be transferred. 


Bit = 1 means 


spare 


Write = 1* 


Read = 1* 


Reserved for Monitor's use 


DECtape direction* 

0 = forward 

1 = reverse 


Must be specified by user. 


(continued on next page) 
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ADDRESS NAME FUNCTION 



12 \ 

13 J> spare 

14 end of medium* 

15 recoverable device* 
error such as parity 
or timing. 

TRNBLK+10 NUMBER OF WORDS 

NOT TRANSFERRED 

User leaves this entry blank. If an 
EOM occurs during the transfer, the 
Monitor will place in this entry the 
number of words not transferred. 


2.9 PROGRAMMING TIPS 

Swapping time can be kept to a minimum by placing like requests together 
in the coding. For example, method 1, below, will require the . INIT 
and the .OPEN processors to be swapped in only once each. However, 
method 2 requires that each be swapped in three times . The exception 
of course occurs if either are made core resident. 


Method 1 

.INIT A 
.INIT B 
.INIT C 


.OPENI A 
.OPENO B 
.OPENO C 


Method 2 

.INIT A 
.OPEN A 
.INIT B 
.OPENO B 


.INIT C 


.OPENO C 


Core can be used more efficiently if datasets which are to be used 
the longest (i.e., . RLSEd last) are . INITed first. Such action is effi- 
cient because free core is allocated from the bottom, and if the more 
permanent routings are allocated first (i.e., at the bottom) then larger 
areas of free core will become available as less permanent routines are 
released from the top. Thus, method 1 below is potentially more effi- 
cient than method 2. 

Method 1 Method 2 

.INIT C .INIT A 

.INIT B 

: .INIT C 

.INIT B 


* 

These bits are cleared before TRAN is carried out. 
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Method 

1 

Me tho d 

_2 

. INIT 

A 

.RLSE 

A 

# 


.RLSE 

B 

. RLSE 

A 



. RLSE 

B 

• 


i 


.RLSE 

C 

. RLSE 

C 




.READ and .WRITE were designed to be used for sequential access to 
a linked file, but are legal for both linked and contiguous files. 

# 

Since .EXIT will cause the user's program to be effectively wiped 
out, if the programmer wishes his program to remain in core after it 
has finished (e.g., for debugging or for immediate re-use), he might, 
instead of. EXIT, use something like 

BR • 

The operator can then specify the next action by recalling the Monitor 
via a command at the keyboard (see Section 3.2). 

In some cases the WAIT or WAITR instructions are not needed. This 
situation is called an Implied WAIT, and occurs because the Monitor 
will only process one action on a dataset at a time. For example, if 
a program is written: 

.READ LNK1 ,BUF1 

.READ LNKl ,BUF2 

the second READ becomes an implied WAIT for the first; since the Moni- 
tor will not start the second until the first is finished with the 
dataset. This implies that when control returns to the user after the 
second READ, he may safely assume the data transferred by the first can 
now be processed. Similarly, if two different datasets reference one 
device in common, action on the second dataset will not proceed until 
action on the first is complete. 

2.10 MONITOR MESSAGES 

Monitor messages are typed on the teleprinter in the following format: 

CNNN XXXXXX 
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where C is on of four letters identifying the type of message: 

I Informational 

A Action required by the operator 
W Warning to the operator 
F Fatal error 

where NNNN is the message number, and XXXXXX gives appropriate addition- 
al information. Informational and Warning messages are printed and the 
program continues. 

Action messages are printed and the program is suspended. The 
Monitor experts the operator to take some action such as "continue the 
program" (type Continue), or "kill the program" (type Kill). 

Fatal error messages are printed if possible, and the program is 
suspended. The Monitor will not allow the operator to continue the 
program, but expects to see either a BEgin, REstart or Kill command. 

If a fatal error is a system disk failure, and the error message cannot 
be printed; the central processorhalts . This is the only time that a 
halt occurs in the Monitor. 

If the error has been caused by a stack overflow, the stack pointer 
is reset before the message is printed. Monitor's error messages are 
listed below. 

The following are action messages: 


Error Additional 

Message Information Remarks 


A001 

USER CALL ADDRESS 

Disk address error 

A002 

DEVICE NAME ( RAD 5 0 ) 

Device not ready 

A003 

LINK BLOCK ADDR. 

No Device or Illegal 
Device or INIT 

A004 

USER CALL ADDRESS 

DECtape error. Command CO 
will retry the operation. 

The 

following are fatal error 

messages : 

Error 

Message 

Additional 

Information 

Remarks 

F000 

Request Address 

Dataset not Inited 

F001 

Request Address 

Stack overflow 
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Error 

Message 

Additional 

Information 

Remarks 

F002 

Request Address 

Invalid call 

F003 

Request Address 

Invalid .TRAN function 

F005 

Request Address 

.RLSE error (no .CLOSE after 
.OPEN on file structured de- 
vice ) 

F006 

Request Address 

Device full (new file cannot 
be .OPENed) 

F007 

Request Address 

No buffer space 

F010 

Request Address 

Illegal . READ/. WRIT® (in- 
correct mode for device or 
file not OPENed correctly) 

F011 

Request Address 

T 1 1 orfq 1 nnori / nnncoH r\ir 

type unsuitable for device) 

F012 

Request Address 

Invalid open (no program 
return provided for failure) 

F014 

Request Address 

Bit map failure (device error 
on trying to read bit map) 

F015 

Request Address 

DECtape error (nonexistent 
memory addressed or end- zone 
reached dummy transfer) 

F0I7 

Device (RAD50) 

File structures device parity 
error 

F020 


Too many datasets using low 
speed paper tape (a maximum o: 
one for each direction is al- 
lowed) . 

F021 

Irrelevant 

Program Loader read failure 

F022 

Irrelevant 

Program Loader format error 
(program is not in absolute 
load format) . 

F023 

Program Size 

Program too large for core 
available . 

F024 

Request Address 

Illegal file structures opera' 
tion, e.g., Delete or Rename 
of an open file. 

FO 25 

Device 

Master Directory full (when 
attempting to add UIC) . 

F026 

Request Address 

Disk transfer failure. 

F342 


Error trap. 
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Error 

Message 


Additional 

Information 


Remarks 


F344 

Reserved instruction trap 

F346 

Trace trap. 

F350 

Power fail trap. 

F352 

Trap instruction trap. 

F356 

Unexpected device 


interrupt . 
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2.11 EXAMPLE PROGRAMS 

Ttis following are assembled listings of two simple programs written in 
and assembled using PAL- HR. The programs contain many of the Monitor's 
programmed requests. 



/PROGRAM WHICH TYPES A message ON THE TFLFTPF whIlE 
/accepting a message from the keyboard, program repeats 


CK0PI0CK0 
0S5000 i 

000002 

000003 

000004 

000005 

000006 

000007 

-a M nil K 
/) l -J 

000012 

000011 

000107 


000000 

012746 * BEGIN! 
000312 

MQV 

#LNK1 ,-CSP) 

UNIT LNK1 

000004 

104006 

EMT 

6 


000006 

012746* 

000324 

MQV 

*LNK?,-(SP) 

? I NI T LNK 2 

000012 

104006 

EMT 

6 


000014 

012746 * 

000340 

MQV 

#FIL1 ,-CSP) 

/ ope n Fn» output 

000020 

012746 ' 

000312 

MQV 

*LNKJ ,-CSP) 


000024 

104016 

EMT 

16 


000026 

012746 * 

000356 

MOV 

*FIL2.-(SP) 

/open fqr Input 

000032 

012746* 

000324 

MOV 

*LNK2.-(Sp) 


000036 

104016 

EMT 

16 


000040 

012746 * 

000370 

MOV 

*m5S1»-(8p) 

/WRITE THF MESSAGE 

000044 

012746 • 

000312 

MQV 

PLNK1 ,-C5PD 


00IA050 

104002 

EMT 

o 


000052 

012700 * 

000170 

MQV 

*LIB1*6. Rp 

/set the buffer pointer 

000056 

005020 LOOP 1 1 

CIW 

(R05 ♦ 

/CLEAR THE ADDRESS AND INCREMENT 

000060 

020027 * 

000302 

CMP 

R0i PLI61*60 

, /end of buffer? 

000064 

103774 

SLO 

LOOP 1 

/ NO f GO BACK A CONTINUE CLEARING 

000066 

012746 » 

000312 

MOV 

#LNK 1 , • f S p) 

fVESfCONTINlje 

000072 

104001 

EMT 

1 


000074 

012746 * 

000162 

MOV 

*LIB 1 ,-C5P) 

/NO. Read LNK2 # L 1 3 1 

000100 

012746* 

000324 

MQV 

RL'VKPi-fSP) 


000104 

104004 

EMT 

4 


000106 

012746 » 

000324 

MQV 

*»LNK2,-CSP3 

/WAIT 


K 0»%0 

R 1 ®% 1 
R2«%2 
R3«%3 
R 4 ■ X 4 
R5«X5 
SP-X6 
PC«X7 

r L3 m A C 

v- ^ — Jk *7 

LF» 1 2 
ht« 1 1 

fc RQR* 1 07 
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000112 

J 0400 1 

EMT 

1 


0001 W 

132707 

000107 

000043 

BITB *ER0R,LlBi*3 / ANY ERRORS? 

080122 

001016 

BNE 

ERR3 

} YfS r GO TO TM£ £RpQR*J 

000124 

012746* 

000312 

MOV 

•URKlf-CSP) 

ino. .close ln*i 

000130 

104017 

EmT 

17 


000132 

012746* 

000324 

MOV 

#INK2,-CSP3 

I. CLOSE LNK? 

000130 

104017 

EMT 

17 


000140 

012746* 

000312 

MOV 

*INK1,.($P) 

I.RLSE L Nk 1 

000144 

104007 

EMT 

7 


000140 

012746* 

000324 

MQV 

#LNK2,-(SP) 

I.RLSE L^<2 

000152 

104007 

EMT 

7 


000134 

000167 

177620 

EnRl 1 
ERR?* 
ERR3« 

JMP 

begin 


000160 

104060 

EMT 

60 

/ EXIT on any error 


000102 

00P120 

LIB 1 1 

,*ORD B0. 

/max byte count 

000104 

000 


•BYTE 0,0 

/FORMATTED ASCII 

000165 

000 




000166 

000000 


.WORD 0 

IACTUaL byte COUNT 


000310 


.*.*80, PRESERVE 

TME BUFFER SPACE 

000310 

000160 * 


. 4QRQ ERR 1 

IERPOR RETURN ADDRESS 

000312 

000000 

LNKl 1 

• *QRD 0 /POINTER 


000314 

016027 


, R AQ50 /DS 1 / 

/LOGICAL name 

000316 

001 


.BYTE 1,0 

/UNIT 0 

000317 

000 




000320 

042420 


• R AO50 /KB/ 

/ KEYBOARD 

000322 

000160 * 


• *0R0 ERR2 

1 ERR OR RETURN ADDRESS 

000324 

000000 

IN«2I 

• RORD 0 


000326 

016030 


.RAQ50 /0S2 / 


000330 

001 


•BYTE 1,0 


000331 

000 




000332 

042420 


• R AQ50 /K8/ 

/KEYBOARD 

000334 

000000 


.WORD 0 /GO TO FATAL ERROR MESSAGE 

000336 

002 


•BYTE 2,0 

/OPEN FOR OUTPUT 

000337 

000 




000340 

000000 

FlLl » 

•WORD 0,0, 0,0,0 

/NO name, ext, Ulc, OR protect 

000342 

000000 



000344 

000000 
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090346 090009 
000350 000009 


000392 

000000 

• WORD 

0 IGO 

000394 

004 

• 8YTE 

4,0 

000395 

000 



000396 

000000 7H2! 

. 40RD 

0,0,2, 

009360 

099000 



000362 

000000 



000364 

000000 



000360 

000090 



090370 

009210 wgG 1 1 

.RORD 

219 

000372 

000 

• BYTE 

0,0 

000373 

000 



000374 

000205 

• *ORD 

MS6EN0 

000376 

015 

• BYTE 

CR,LF, 

000377 

012 



000400 

011 



000401 

040 

.ASCII / 3PE 

000402 

123 



000403 

120 



000404 

195 



000405 

101 



000406 

113 



000407 

040 



000410 

122 



000411 

117 



090412 

125 



090413 

107 



000414 

110 



000415 

114 



00041$ 

131 



000417 

040 



000429 

124 



000421 

117 



000422 

040 



090423 

131 



000424 

117 



000425 

1?5 



000426 

122 



000427 

040 



000430 

114 



000431 

ill 



000432 

124 



000433 

124 



000434 

114 



000435 

105 



000436 

040 



000437 

102 



000440 

117 



000441 

131 



000442 

040 



000443 

015 

• BYTE 

CR,L7, 

000444 

012 




TO FATAL ERROR 

iqpen For Input 

0,0 INO N A M e , EXT, UlC# O* PROTECT 


JMA* BYTE COUNTS 
fPQRKATTEn ASCII 

"MSGl-4 FACTUAL byte COUNT 

HT 

AK ROUGHLY TO YOUR LITTLE HOY / 


H T , 
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000445 

011 

000446 

000 

000447 

040 

000490 

101 

000491 

116 

000492 

104 

000493 

040 

000494 

102 

000495 

10S 

000456 

101 

000497 

124 

000400 

040 

000461 

110 

000462 

111 

000463 

U9 

000464 

040 

000465 

127 

000466 

110 

000467 

1 05 

000470 

H5 

000471 

040 

000472 

1 10 

000473 

105 

030474 

040 

000479 

123 

000476 

116 

000477 

105 

000500 

1?5 

000501 

132 

000902 

105 

000503 

123 

000504 

040 

000505 

015 

000506 

012 

000507 

011 

0055510 

040 

000511 

110 

000512 

105 

000513 

040 

000514 

117 

000515 

116 

000516 

114 

000517 

131 

000520 

040 

000521 

104 

000522 

117 

000523 

105 

000524 

123 

000525 

040 

000526 

HI 

000527 

124 

000530 

040 

000531 

124 

000532 

117 

000533 

040 

000534 

101 


.ASCII / AND BEAT HIM HHEM 


.byte CR,LF,HT 


.ASCII / ME Only DOF-S IT T 


HE SNEEZES / 


annoy / 
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000535 115 

000535 11 fi 

000537 117 

0005^0 131 

000541 040 

000542 015 . 8 VTE CR#LF,B7 

3ggj4j wig 

000544 011 

000545 040 .ASCII / BECAUSE **F. <MU'*S IT TFA$FS / 


000546 

102 


000547 

105 


000530 

103 


000551 

101 


300552 

125 


000553 

123 


000554 

105 


000555 

040 


000556 

110 


000557 

105 


000550 

0 40 


000551 

113 


000562 

ll6 


000563 

117 


000564 

127 


000565 

123 


000566 

040 


000567 

111 


000570 

124 


000571 

0 40 


00057g 

1 34 


000573 

1 0 5 


000574 

l0t 


000575 

123 


000576 

105 


000577 

123 


000600 

040 


000601 

015 

.SVTE 

000602 

012 



000603 M 5 G E, N P a 

' • 


000604 

.E^EN 


00000 1 

. E NO 

BEGIN 

000000R 

C« 

ERRl 

000 1 60R 

ERR? 

Fill 

000047k 

FIL2 

IF 

* 000012 

L I B 1 

LN«2 

0 0 0 3 2 4 R 

lPQRI 

MSG 1 

000377R 

PC 

R 1 

■X000001 

R2 

R 4 

1X000004 

R5 

4 

* 000604R 



CR,I.F 


a 00 0 / 1 5 

F R n R 

s /00107 

0 0 01 6 7 R 

ERR 3 

0 1 0 1 6 ? R 

0 0 0 3 5 6 R 

ht 

a 0 0 0 0 1 1 

0 0 0 1 6 2 R 

t_ Nj < 1 

0 0 / 3 1 2 R 

000056R 

M S G E M L 

; a 000K03R 

SX000007 

R0 

a X 7 0 0 * 0 0 

■X000002 

»3 

S X 0 A 0 0 4 3 

1X000005 

SR 

aX0 40006 


2-73 



Example Program #2 


I PROGRAM TO DUPLICATE a PAPER TAPE 
I USING TRAn-LEVEL peoufsts 


1 



000000 

P0s%0 




000006 

SP*X6 




000007 

PC»%7 




000015 

CR»15 




000012 

LF« 1 2 




000011 

HT«U 




000004 

»D»04 

iTrauBlOc* function cope 

F PR .REAP 


000002 

wR«02 

jTPANBlOC* function code 

FOR ."RITE 


000107 

Ga 1 07 

»ASC!I G 



040000 

EOUa40000 

iTrak block f unction/ status aEnn 


000107 

ERORa 107 



000000 

01274$’ BEGIN ! 
00041$ 

NOV *UN<1,-CSP) 

».INIT LNK1 


000004 

104006 

EMT 6 



00000$ 

012^46 » 

000430 

MOV #LN<2»- fSPJ 

J.INIT LNK2 


000012 

10400$ 

EMT 6 



000014 

012746 « 

00034$ 

mqv *LN*3,- C SP 3 

riNjT LNK3 


000020 

10400$ 

EMT $ 



000022 

01274$' 

000372 

MOV #LN<4,»fSp) 

I.INIT LNK 4 


00002$ 

104006 

EmT $ 



000030 

005067 STArTi 

CL« FLAG1 

f ZERO ENO Flag 



00021 « 


000034 

0127$7 

MQV *100,, 

>biki+4 iinitializf buffer SIZE 

000042 

000 1 44 
000344 
005067 

CLP 

BUF 1 *6 

UNITIALIZE input buffer 

000046 

000316 

005067 

CLP 

BUFl+10 

UNITIALIZE INPUT RUFFFR 

000052 

000314 
012746 » 

MQV 

#MSG1 ,« (SP) 

1 • i*F I TE LN<3 »msG1 

000056 

000246 
012746 ' 

MOV 

*LNK3, • ($ P) 

1 

000062 

000346 

104002 

EmT 

2 


000064 

0127461 

mqv 

*LNK3»-(SP) 

U w A I T LNK3 

000070 

000346 

104001 

EMT 

1 

000072 

012746 ' 

MOV 

*BUF1,-(SP) 

I.REAB LNK4,BUFi 

000076 

000356 
012746 » 

MQV 

*LNK4,-fSP) 

000102 

000372 

104004 

EmT 

4 


000194 

012746' 

MOV 

*LNK 4 , » ( SP ) 

I.NAIT L N< 4 

000110 

000372 

104001 

EMT 

1 

000112 

132707 

BITB 

#EPQR » BUF 1 *3 


000241 
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030120 

030122 


000130 

000132 


000140 

000144 

000150 

000152 

000155 

000150 


300165 

003170 


000175 


0 0 0 J 0 4 


000212 

300216 

000222 

300224 

000233 

000232 

000235 

000240 


000242 

000244 

000246 

000250 

000251 

000252 

000254 


001050 

122760 


BnE ERRS 

CmPb *G,BUF1*6 

i G? 

000107 

0 0 0 2 3 4 
301337 


8nE start 

1 MQ 

1127*7 

LnOpRt 

MQVB *RQ,HLk1*6 

iyEs.sEt up Re An 

300004 

000250 

0 1 ?7 46 1 


MQV *Bl<l#"CSP) 

f , TR AN 1 , «L< 1 

000402 
312746 * 
300416 
134310 

3 1 ? 7 45 1 


Mgv 1 r « (5P) 

EmT 13 

MOV *LN<1,-(SP) 

? , " A I T LNK 1 

000416 

134001 

332767 


EMT 1 

BIT *E00tBlKi*6 

1 T p 5 T FUNCTION F n* Eon 

040000 

000222 

001406 

166767 

E Ni O M 1 

BEQ LOOP" 

SUB BtKl+10,8LK 

1 + 4 t RESET * 0 R n C o U n T To final 

000216 

000210 

012767 


MQV *1 # FLAG1 

t BUFFER'S size 
•SET EOo-flaG 

000001 

000040 

112767 

LOOP* | 

M 0 V B *"R, BL< 1+6 

r S F T UP "RUE 

000002 
330176 
012746 * 


MOV 9BLK1.-CSP) 

I. TRAN LM<?.BL<1 

000402 
312746 i 
000430 
104010 
012746 « 


MOV **LN<2 » - (Sp) 

fcMT 10 

MOV #IN*2,k(SP) 

f * * a i t Ink? 

000430 

104301 

005767 


EMT 1 

T ST FLAG1 

f E ND OF DATA? 

000006 

001274 


BnE start 

pYpSr START OVER 

000734 


8k LOOP* 

1 N 0 » GET mqRE 

104360 

e»*i * 

EP*21 
£R*3t 
ER*4 I 
ERR5 1 
EP«6 * 
EP*7 * 

EMT 63 

ifxtt On anv ERROR 

000003 

FLAG1 i 

.BORO 0 

>1=>E00 RECEIVED On rEaO 

000067 

MSG 1 l 

,"0*0 55, 


003 

000 

0.00067 

015 


•BYTE 0»n 

•*0R0 55. 

• BYTE C* » L F » M T 
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000255 

012 


000256 

011 


000257 

114 

.ASCII /LOAD T 

000260 

117 


000261 

101 


000262 

104 


000265 

040 


000264 

124 


000265 

101 


000266 

1 20 


000267 

IDS 


0002?0 

040 


000271 

111 


000272 

116 


000273 

124 


000274 

117 


000275 

040 


000276 

122 


000277 

105 


000300 

101 


000301 

1 0 4 


000302 

105 


000303 

122 


000304 

015 

.byte cr,lf,*t 

000305 

012 


000306 

011 


000307 

120 

.ASCII /PUSH 

000310 

125 


000311 

123 


000312 

i 10 


000313 

040 


000310 

040 


000315 

04 0 


000316 

040 


000317 

1 07 


000320 

054 


000321 

040 


000322 

1 03 


000323 

122 


000324 

040 


000325 

040 


000326 

040 


000327 

127 


000330 

110 


000331 

105 


000332 

116 


000333 

040 


000334 

122 


000335 

105 


000336 

101 


000337 

104 


000340 

131 


000341 

015 

.BYTE CR,l.F 

000342 

012 



000344 

.EVEN 

000344 

020242 * 

.wORD ERP3 


READER/ 


WHEN READY/ 
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000346 

000000 LN*3 * 

.* OSD 0 

000350 

016027 

.RA 053 /nsi/ 

000352 

00 t 

.BYTE 1,0 

000353 

000 


000354 

042420 

■ 9 AQ50 /KB/ 

300356 

000004 BuFl 1 

.-(090 4 

000350 

000 

.BYTE 0,0 

0003^1 

00 0 


000352 

000004 

.'*090 4 


000370 

9 s 3 ^ 4 


00037 0 

• EVEN 

000370 

000242 1 

. *090 ER94 

000372 

000000 LmMS 

,-iQftD 0 

000374 

016027 

.9AQ50 /0S1/ 

000376 

001 

.BYTE 1,0 

000377 

000 


000400 

n 4 A 4 A 7i 

0 4 g fl 2 v 

a A rs k a / j a j 

i r f jg%} /■ * v ■ ■* * 

000402 

200000 9l_M J 

,'-(090 0 

000404 

000440 • 

.*'090 8UP2 

000406 

0001144 

,*090 100, 

0004U 

00000? 

,*o»o 0 

000412 

000000 

,*09D 0 

000414 

000242 t 

,*09D E9R3 

000416 

000000 LKK\i 

. *09Q 0 

000420 

016031 

.9*050 /DS3/ 

000422 

001 

•BYTE 1,0 

000423 

000 


000424 

063320 

.9AO50 /PR/ 

000426 

000242 « 

,*090 E992 

000430 

000000 LN«2» 

. *090 0 

000432 

0 16032 

.9AO50 /0S4/ 

000434 

001 

.byte 1,0 

000435 

000 


000436 

063200 

.RA053 /P P/ 


000604 BllF2: 

,«,+100, 


000001 

.6 NO 


BEGIN 

000000R 

BLK1 


0004029 

BUF 1 

BUF2 

000440P 

C* 

a 

00 0 0 1 5 

f N 0 H 

EOn 

■ 040000 

E909 

a 

000107 

EWR1 

ERR2 

000242R 

E993 


0002^29 

E994 

ERRS 

400 

E996 


0002409 

E R 9? 

FLAG1 

0002449 

r. 

a 

000107 

hT 

LF 

■ 000012 

L^Kl 


0004169 

L N * 2 

INKS 

0003*69 

(_NK4 


0003729 

LOOP* 

L00 p * 

0000049 

*SG1 


0002469 

PC 

RD 

■ 000004 

90 

S%00000? 

SP 

START 

0000309 

*9 

B 

000002 

9 


? 0 / 3 3 6 9 
0 3 ? ! 7 5* 9 
7^S5?4JR 

qr%*2*2* 

2 ./ 0 ? 4 2 « 
a 0 0 g St 1 1 
0004309 
0 0 0 1 3 2 9 
a y. 0 / 0 0 0 7 
s % 0 0 0 i* 4 6 
a 0 0 0 6 4 4 9 
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CHAPTER 3 


OPERATOR COMMANDS 


3.1 THE OPERATOR KEYBOARD INTERFACE 

Through the operator keyboard, the user can communicate with 

• the Monitor 

• a program the user wrote to run under the Monitor 

• a DOS system program (Assembler, PIP, Editor, etc.) 

Rules which are common to all users of the operator keyboard under DOS 
are described in Section 3.2. 


In communicating wrth the Monitor, the keyboard is used as a control 
device to allocate system resources, move programs into core, start and 
stop programs, and exchange information with the system. Commands which 
the user can type are summarized m Appendix D and described in detail 
in Section 3.3. 


For use in communicating with a system ^ro^ram or 


IS©] 


tii 1 1 f 


the operator keyboard functions as a normal input device; the data from 
the keyboard may be transferred to a buffer in the program, or it may be 
preprocessed by a special routine called the Command String interpreter 
(CSI) described in Section 3.4. 


When the system requests input from the keyboard, a single charac- 
ter is printed on the teleprinter: 


r*u ^ ^ -v- 

'w-.ia.-L. a‘w l-cjl 


$ 


# 

* 


Hed.iii.ng 

The system is idle and will remain idle await- 
ing an operator command. 

The Monitor has acknowledged a CTRL/C typed by 
the operator and is in listening mode, ready 
to accept a message .from the operator. 

A system program or user's program requests 
an operator reply through the CSI. 

A system program requests an input message 
directly (i.e., not through CSI). 
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3 . 2 COMMUNICATING THROUGH THE KEYBOARD 


Since the Monitor and any program operating under it must share the key- 
board, the user must specify whether a given keyboard input is intended 
for the Monitor or for the operating program: 

• All characters following a CTRL/C (typed by holding down 
the CTRL key while typing the C key) through the next 
RETURN are interpreted as Monitor commands and are 
passed to the Monitor for execution. 

• All other characters are assumed to be intended for 
the operating program, provided one is currently in 
core and the keyboard device has been associated with 
one of its datasets. In this case, the characters 
will be buffered until required by the program. The 
characters will be ignored if no program has been 
loaded or if it is not using the keyboard as one of 
its data media. 

Certain keys on the keyboard have special functions. These are 
listed in Table 3-1. 

3.3 MONITOR COMMANDS 

A command to the Monitor consists of two parts: a command name and pos- 
sibly one or more command arguments. A command name is a string of two 
or more characters; all characters after the first two, and up to a de- 
limiter, are ignored. The command formats are given in this section. 

The following conventions apply: 

• Brackets [ ] are used to enclose elements of the 
command which are optional, i.e., they may appear 
or not appear depending on the desired Monitor re- 
action. 

• Braces { } are used to indicate that a choice must 
be made from the enclosed information. 

• A comma , indicates that either one comma and/or 
a space must appear in that position. 
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TABLE 3-1 

SPECIAL KEYBOARD FUNCTIONS 

Keyboard 

Key Function 

RETURN Pressing RETURN terminates an operator com- 

mand to the Monitor or a line of input to 
a system or user program. RETURN is gener- 
ated on the teleprinter as a carriage return 
and LINE FEED. 

RUBOUT This key permits the correction of typing 

errors. Pressing RUBOUT once causes the 
last character typed to be deleted. RUBOUT 

j does not delete characters past the previous 

| . 1 

line terminator. If the last character of 

i a Command has already been deleted, a RUBOUT 

will echo as RETURN,* LINE- FEED, and the user 

must type CTRL/C to input the command anew. 

A RUBOUT given in the same circumstance 

within a line of program input will produce 

no response. 

The Monitor prints the deleted characters 
delimited by backslashes. For example, if 
one were typing .APPEND and typed .APPAM 
instead, the error can be corrected by typing 
two RUBOUTS and then the correct letters. 

The typeout would be: 

j 

i 

appam\ma\end j 

1 

i 

Notice that the deleted characters are shown i 

j 

in reverse order, i.e., in the order in which j 

they are deleted. | 

i 

I 



1 = a line terminator is a LINE FEED, j 

FORM FEED, or VERTICAL TAB. | 

(continued on next page) 
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TABLE 3.1 (Cont'd) 


Keyboard 

Key 

Function 

CTRL /C 

When the CTRL key and C key are pressed, 
the Monitor is alerted to accept a com- 
mand from the keyboard. CTRL/C is echoed 
as +C RETURN LINE FEED period. 


The operator can then type in a command 

to the Monitor; while the command is 
being typed, the interrupted program con- 
tinues running normally (except that any 
output to the teleprinter is interrupted 
until the command is terminated by the 

RETURN key. 


CTRL/C will interrupt teleprinter output 
or keyboard input in a user program. How- 
ever, Monitor action on a CTRL/C is not 
taken until any current Monitor command 
is completed because the keyboard inter- 
rupt is turned "off"). Except for DUmp 
and Modify, however, it appears to the 
user that action on a CTRL/C is immediate. 


CTRL/C puts the Monitor in listening mode 
only. If it is desired to stop the func- 
tion of the operating program, the STop 
command (Section 3. 3. 4.1) should be used. 


If a second CTRL/C is typed before the 

RETURN terminating a Command, the input 
so far will be erased, a fresh tC RETURN 

LINE FEED period will be printed and the 
Monitor will await a new command. 


(continued on next page) 
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Table 3-1 (Cont'd) 



Keyboard 



Key 

Function 


CTRL/U 


i 


i 


j 


CTRL/U is used if the user has completely 
mistyped the current line and wishes to 
start it over (CTRL/U deletes the entire 
line back to the last line terminator) . 

When given in a Command, it will echo as 
1U RETURN LINE-FEED and the user must type 
CTRL/C to enter the command anew. CTRL/U 
given within a line of program input will 
merely echo as + U. CTRL/U may also be 
used to stop the printing of the current 
line of program output provided that no . 
other input characters are still awaiting ' 
processing by the program. In this usage, 

1 

it will not be echoed. i 


i 


i 


; causes all characters up to the line 
terminator within a command string to be ' 
treated as comments. It effectively puts 
the keyboard off-line — all characters 
S following are echoed, but no Monitor ac- 
tion is taken. If a ; appears on a line and 
I no fC has been issued, it is passed to 
! the user program's buffer like any other 
. character. 

i (concluded) I 

1 i 
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(Section 3.3. Continued from page 3-2.) 

• DEVICE NAME refers to a physical device name 
as listed in Appendix A. 

• DATASET SPECIFIED may be represented by any 
portion of the expression: 

DEV : FILENAM . EXT , [UIC] 

where 

DEV: is a physical device name as 

listed in Appendix and is 
followed by a colon. 

FILENAM is a file name of up to 6 
characters . 

.EXT is a period followed by a file- 

name extension of up to 3 charac- 
ters . 

UIC is the user's identification 

code in the form 

Group No., User No. 

• LOGICAL NAME is the name given to the Dataset 
by the user in link block word LNKBLK +2. 

NOTE: To distinguish in the examples between the echo 

from an operator command on the teleprinter and 
the Monitor's solicited response, the Monitor's 
response will be underlined. 

RETURN is represented by J and is echoed by 
the Monitor as RETURN LINEFEED. 

NOTE: An invalid command causes the error message 

BAD CMD - IGNORED 

to be typed on the teleprinter, and the com- 
mand is ignored. 
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3.3.1 Commands to Allocate System Resources 


3. 3. 1.1 The ASsign Command 

AS [SIGN] [/DATASET SPECIFIER, LOGICAL NAME] 

The ASsign command assigns a physical device (and, when the device is 
file structured, a file name) to the dataset specified by LOGICAL NAME. 
The ASsign command overrides any assignment made in the dataset's link 
block. If no FILE NAME is specified in the DATASET SPECIFIER, then the 
file name in the associated filename block is used. Any FILE NAME speci- 
fied for a non-f ile-structured device is ignored. 

Note that a device is assigned to a dataset, and that reassigning it for 
one dataset does not reassign it for all datasets. 

The ASsign command can be given at any time the Monitor is in core: 

• If ASsign is given before a program is loaded, 
the device assignment will remain in effect 
until another ASsign is given with no argu- 
ments, or until the Monitor itself is reloaded. 

ASsign given at this time enables the user 

to specify the same assignment for a suite 
of programs to be run. 

• If ASsign is given after a program is loaded, 

(i.e., after a GEt command), the assignment 
will remain in effect as long as the program 
is in core, or until the programmer performs 
a re— assignment , As soon as the program dis- 
appears (by an .EXIT request or a Kill command), 
the assignment is released. 

• ASsign may also be given after a program is 
running. For example, as recovery from a 

A003 message (Device not available) 

the user would do an ASsign followed by con- 
tinue. The assignment will remain in effect 
as long as the program is in core, until the 
programmer re-assigns, or restarts the program 
by a BEgin command. 
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Doing an ASsign at this time is provided 
for such emergency situations, but is not 
recommended as standard practice because 
it causes an extra buffer to be allocated 
from free core and it will only be effect- 
ive if the program has not already INITed 
the dataset to some other device. 

For example, to assign DECtape file FREQ . BIN to dataset FRQ : 

tc 

^AS DT: FREQ. BIN, FRQ 

3. 3. 1.2 The OTher Command 

OT [HER] , DATASET SPECIFIER 

The stated DATASET is made the Monitor command device. The keyboard 
may recover control as command device with +C from its keyboard or by 
command OTher KB from the other device. OTher is valid only when no 
program is running. This command may be used to provide a form of batch- 
processing, for example. 

3.3.2 Commands to Manipulate Core Images 
3. 3. 2.1 The RUn Command 

RU [N] , DATASET SPECIFIER 


The RUn command loads the specified program from the specified device 
and starts its execution at the normal start address. The RUn command 
is equivalent to a GEt command followed by a BEgin command. RUn is 
valid only when there is no program already loaded. 

• If a READ error occurs during the loading of 
the program, a fatal error message F021 XXXXXX 
is printed. 

• If RUn calls a program which is not in the 
proper form (i.e., is not in formatted binary 
or does not have a start address) , it produces 
a fatal error and the following message is 
printed : 

F022 XXXXXX 
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• If the program to be loaded is too large for the 

available core, the fatal error message F023 
[PROGRAM SIZE] is printed. Recovery from all 
these errors will be by way of a Kill command. 

3. 3. 2. 2 The GEt Command 

GE[T] ,DATASET SPECIFIER 

The GEt command loads the specified dataset from the specified device. 
GEt is valid only when there is no dataset already loaded. Error re- 
porting will be the same as for RUn. The user should use a BEgin com- 
mand to commence execution. 

3. 3. 2. 3 The DUmp Command 

DU [MP ] , DEVICE NAME: i |^ STAR T ADDR ][,END ADDR] J 

This command writes an absolute copy of the specified core area to or 
from a fixed area on the specified device. I in the second argument 
specifies dump to core, and 0 specifies a dump from core. The core 
image is not altered. An 0 is assumed on default. 0 is assumed if 
no START ADDRESS is specified, and the highest word in memory is as- 
sumed if no END ADDRESS is specified. DUmp is valid at any time; if 
given while a program is running, it will merely suspend operations for 
the time taken to effect the dump. 

3.3. 2. 4 The SAve Command 

SA [VE ] 

SAve writes the program in core on the system disk in loader format. 

The core image is not altered. SAve is valid only when a program is 
in cots but is not min nine • 

The file which is created is always named SAVE . BIN , on dataset SAV, 
device DF . Before this file is created the Monitor deletes any file in 
the user's area on the disk with the same name. Thus, if it is desired 
to retain the saved file for any length of time, it should be renamed 
or copied to another area and given a new name, by means of PIP. 

The SAVE file may be directed to any device other than DF by AS- 
SIGNning the dataset SAV to the desired device. 
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The segment of core which is saved starts at the initial program load 
address and ends with the last word in memory. The saved image will be 
preceded by the same communication information as that for the original 
program loaded. 

3.3.3 Commands to Start a Program 

3. 3. 3.1 The BEgin Command 

BE [GIN] [, ADDRESS] 

The BEgin command starts the execution of a program at the stated ad- 
dress. If no addrdss is specified, the address used will be the normal 
start address. This command is valid only if a program is already in 
core. BEgin is used after a GEt, a STop, or following a fatal error 
condition. The GEt command followed by a BEgin command is equivalent 
to a RUn command. If given after a program has been started, a BEgin 
will clear all core allocations to a buffer, devices and assignments 
made dynamically and the stack will be cleared before control is passed 
back to the program. 

To start a program at its normal start address, type 

BE 

To start a program at location 3446, type 
BE, 3446 

3. 3. 3. 2 The Continue Command 

CO [NTINUE] 

This command is used after a WAit or a recoverable error condition 
(operator action message) to resume program operation at the point where 
it was interrupted. It is valid only if a program is already in core. 

3.3.3. 3 The REstart Command 


RE [START] [, ADDRESS] 

This command restarts the program at the given address. If ADDRESS 
is not specified, the address set by the .RESTART programmed request 
(Section 2. 8. 2. 2) is assumed. If neither address is specified, the 
command is rejected. 
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REstart is valid only if a program is already in core. Before 
the resumption of operations, the stack will be cleared; any current 
I/O will be stopped and all internal busy states will be removed. How- 
ever, buffers and drives set up for I/O operations will remain linked 
to the program for further usage. 

3.3.4 Commands to Stop a Program 

3. 3. 4.1 The STop Command 

ST [OP] 

This is an emergency command to stop the program, and kill any I/O in 
progress (by doing a hardware reset) . The program may be resumed with 
either BEgin or REstart. STop is valid only if a program is in core. 

3. 3. 4. 2 The WAit Command 

WA [IT] 

This command suspends the current program and finishes any I/O in pro- 
gress. Program can be resumed with a continue or a REstart command. 
WAit is valid only if a program is in core. 

3 . 3 . 4 . 3 The Kill Command 

KI [LL] 

This command stops the execution of the current program, after closing 
all open files and completingany outstanding I/O, and removes the pro- 
gram from core by returning control to the Monitor. It is valid only 
when a program is in core. The user must reload the program or load 
another by RUn or GEt, to resume operations. 

3.3.5 Commands to Exchange Information With the System 
3. 3. 5.1 The DAte Command 

DA [ TE ] [ , DAY ] 

This command sets the Monitor's date-word to the date specified in DAY, 
or if DAY is not specified, it prints the date previously specified. 
DAte is valid any time. (It should be noted that the date-word will 
not be updated internally; the operator must reset it daily if such 
information is needed.) DAY is specified in Julian, i.e., 71026 for 
January 26, 1971 
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3 . 3 . 5 . 2 The Time Command 


TI [ME] [ , TIME] 

Sets the time of day entry in the Monitor to the TIME if TIME is speci- 
fied, otherwise types the present content of the time of day. The for- 
mat of TIME is: 


HH :MM: SS 

where HH = hours 

MM = minutes 
SS = seconds 

The Time command is valid at any time. 

3.3. 5.3 The LOgin Command 

LO [GIN] ,UIC 

This command allows the user to give his user identification code to 
the Monitor. It is a valid command only when there is no program loaded 
in core and provided no other user has logged in and not Finished. 

3. 3. 5. 4 The Modify Command 

MO[DIFY], OCTAL ADDRESS 

OCTAL ADDRESS/CONTENTS: NEW CONTENTS 


This command allows the user to make changes in the contents of the 
absolute memory location specified by OCTAL ADDRESS. After RETURN is 
typed at the end of the first line, the system responds by typing the 
CONTENTS of that address. At this point, the user can type one of the 
following (^denotes the RETURN key): 

J will leave the CONTENTS 

unmodified 

NEW CONTENTS J will change CONTENTS to 

NEW CONTENTS 


This command is valid at any time. To change the contents of 
location 40000: 

tc 

.11040000 J 

1?4 00 00/1640 60 : 104060^ 
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Then to examine the contents of 40000 : 


tc 

^11040000^ 
$40000/104060: ) 


3. 3. 5. 5 The Finish Command 
FI [NISH] 

This command informs the Monitor that the current user is leaving the 
system. This command is valid only when no user program is in core. 

The Monitor deletes all files which do not have bit 7 on the protect 
byte (Figure 2-11) set. This byte can be set at the file's creation, 
or by the .KEEP programmed request (Section 2.7.6). 

3.3.6 Miscellaneous Commands 

3. 3. 6.1 The ECho Command 

EC [HO] 

This command suppresses teleprinter echo from the keyboard input to a 
user program. A subsequent ECho command turns the echo on again. The 
teleprinter as an output device for the program or the Monitor is not 
affected. 

This command is valid only when a program is running in core and 
using the keyboard as a device. 

3.3. 6. 2 The PRint Command 

P R [ TNT ] 

This command suppresses teleprinter printing when the teleprinter is 
used as an output device to a user program. A subsequent PRint command 
turns the printing on again. PRint is valid only when a program is 
running in core and is using the teleprinter as a device. 

3. 3. 6. 3 The ENd Command 

EN[D] t, {p®} 1 

This command tells the Monitor "there is no more input from device KB 
(or PT)". It effectively generates an End-of-File from the keyboard 
(KB) or paper tape reader (PT) . If no argument is specified, KB is 
assumed. 
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ENd is valid only when a program is running in core. 


3. 3. 6. 4 The ODt Command 

OD[T] [,{*]] 

This command starts the execution of the 0DT-11R Debugger Program. The 
argument specifies which ODT start- address is used: 


(No argument) 


R 


K 


starts at START +0 


starts at START +2 


starts at START +4 


(clear ODT break- 
point table without 
resetting break- 
points ) 

(clears ODT break- 
point table after 
replacing old in- 
structions at break- 
points . 

(leaves breakpoints 
exactly as they are) 


For example, to reset all breakpoint locations to their former in- 
structions and restart ODT: 


+C 

. OD , R 


ODT is valid only when ODT is linked to a program and both are in 

core. 

3. 4 THE COMMAND STRING INTERPRETER (CSI) 

The one common format for input and output dataset specifications to a 
system program is provided through a single Monitor routine, the Com- 
mand String Interpreter. This routine preprocesses the specification 
for whatever system program it was called by. 

The CSI may also be called by a user's program. The user's soft- 
ware interface with CSI is described in Section 2.8.5. 

3.4.1 CSI Command Format 

Whenever a system program requests input through the CSI, a # will be 
printed on the teleprinter and the program will wait for the operator's 
reply. A command under CSI consists of one or more output dataset speci- 
fications, followed by <, followed by one or more input dataset speci- 
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fications. Spaces, horizontal TABs , and nulls may appear anywhere 
in the string and are ignored. A command is terminated by a FORM 
FEED, LINE FEED, or VERTICAL TAB. If RETURN appears within a command, 
the character -which immediately follows must be a space, horizontal tab, 
null, RUBOUT or one of the command terminators; otherwise, an error 
will result. 


< need not occur. If it does, at least one input file specification 
must appear. Only one < per command is allowed. Commands may not be 
continued from line to line. 


A dataset specification must be delimited by a comma. If no items 
at all appear before the comma, then this is interpreted as .this parti 
cular positional field will not be used". For example, suppose a pro 
gram requires three ^uuL.pu<_> u.aua ojjeciixt.duijus. -- 


Dataset Specif ication ,, Dataset Specification 


indicates that the second (output) Dataset will not be generated. 


Each dataset specification is a field which describes a dataset. 

It generally contains information as to where to find the dataset, the 
file name and extension if the dataset is a file, the user identifi'-a 
tion code associated with the file, and one or more switches which re- 
quest various actions to be performed. A dataset specification contain- 
ing all of the above elements would appear as : 

DEV: FILNAM. EXT [UIC] /SWl :V1 : . . . : Vm/SW2 : VI : . . . : Vm, 


The device specification which consists of one or more 
letters, with a maximum of three, followed by a colon. 

The letters identify the device and the digits identi- 
fy the unit. Units must be given in octal. The colon 
delimits this field. Only physical names as listed in 
Appendix A may be specified. For example, DTA1 : is 
the correct specification for DECtape , controller A, 
unit 1. 

If no digits appear, then unit 0 is assumed. If the de- 
vice specification itself does not appear, then the cur- 
rent device is defaulted to the device last specified, 
if there is one; otherwise, it is defaulted to disk (DF) # 
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FILNAM 


.EXT 


[UIC] 


Defaults do not carry across the < , i.e., from 
output to input. 

The file name specification, consisting of one or more 
letters or digits, or exactly one asterisk. The first 
six letters or digits specify the name. All letters 
and digits in excess of six are ignored. 

The file name need not appear. No system-wide deafult 
file name is assumed. 

The extension specification which consists of a period, 
followed by one or more letters or digits, or followed 
by exactly one asterisk. The first three letters or 
digits specify the extension. All letters or digits 
in excess of three are ignored. 

The extension need not appear. No system-wide default 
extension is assumed. 

The asterisk is used to specify "all". For example: 

* . EXT specifies all files with extension .EXT, 
FIL.* specifies all files with name FIL, and 
*.* specifies all files and all extensions. 

The User Identification Code (UIC) specification 
which consists of a left square bracket, followed by 
one or more octal digits or exactly one asterisk, 
followed by a comma, followed by one or more octal 
digits or exactly one asterisk, followed by a right 
square bracket. The field to the left of the comma 
specifies the user within the group. Both fields 
must be given in octal. The largest useable octal 
number is 376 in both cases (0 is invalid). For 
example, [12,136] is the correct specification for 
user number 136 of user group 12. 

As in FILNAM and .EXT, the asterisk specifies "all". 

For example: 
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[*,136] specifies all users whose 

number is 136 

[12,*] specifies all members of user 

group 12, and 

[*,*] specifies all users. 

The user identification code need not appear, in which 
case the default is the identification entered by the 
user currently entering the command. 

/SWmzVl : . . . :Vm = A switch specification which consists of a slash (/) , 
followed by one or more letters or digits, and option- 
ally followed by one or more value specifications. A 
value specification is initially delimited by a colon. 
The value itself can be null, ir consists of one or 
more letters, digits, periods, or dollar signs. Other 
characters are illegal. The digits 8 and 9 are legal. 

For examples: /DATE: 12:20:69 might be a switch to 

enter December 20, 1969 in a date field. 

/DATE: 12:: 69 might enter December, 

1969 in a date field. 

Switches need not appear. If a switch does appear, 
then it need not contain more than one letter or digit 
after the slash. For example 

/S and /SWITCH2 are both legal. 

The first two characters after the slash uniquely iden- 
tify the switch. For example: 

/S is treated as if it were /S null. 
/SWITCH1 and /SWITCH2 are both treated 
as /SW. 

Table 3-2 summarizes the legal command syntax. 
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TABLE 3-2. .CSI COMMAND STRING SYNTAX RULES 


Item 

Which 

Last 

Appeared 

Item Immediately Following 

# 

DEV* 

FILNAM 

.EXT 

UIC 

/SWITCH 

< 

Termi- 

nator 

blank 1 

* 

★ 

* 

E 

* 

* 

E 

E 

* 

★ 

* 

* 

E 

* 

* 

E 2 

E 2 

DEV* 

* 

E 

* 

E 

* 

* 

★ 

* 

FILNAM 

* 

, E 

E 

* 

* 

* 

* 

* 

.EXT 

* 

E 

E 

E 

* 

* 

* 

* 

UIC 

* 

E 

E 

E 

E 

★ 

* 

★ 

/SWITCH 

* 

E 

E 

E 

E 

* 

* 

* 


* 

★ 

* 

E 

* 

* 

E 

E 


Legend* E indicates error. 

* indicates legal. 

Notes* 1 The next item encountered is the first item in the 
command string. 

2 This is an error because the following command is 
meaningless, e.g. , 

.Cterminator 


For example , a device specification immedrately followed by an extension 
specification is an error, whereas a file name specification immediately 
followed by a comma is legal. 

3.4.2 CSI Command Example 

An example of a complete command and its interpretation is: 

FI. El, , DTA1 : F2 . E2/S : KF3.E3 [11,123] , DTB : F4 . E4/ABC , F5 . E5 
which is interpreted as: 

The first position output dataset is to be a file named FI and 
will have extension El. It is to be put on disk unit 0 , and catalogues 
under the ID of the user who entered the command. No switches are as- 
sociated with this dataset. 
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The second positional output dataset will not be generated. 


The third positional output dataset is to be in a file named F2 
and will have extension E2. It is to be put on the DECtape which is 
mounted on unit 1 of controller A. This file is to be catalogued under 
the ID of the user who entered the command. The action indicated by 
switch S is to be performed assuming value 1 on this dataset. 

The fourth and subsequent positional output dataset will not be 
generated. 

The first positional input dataset is a file named F3 , and its 
extension is E3. It can be found on disk unit 0 , catalogued under the 
user number 123 of user groip 11. No switches are associated with this 
dataset. 

The second positional input dataset is a file named F4 and its 
extension is E4. It can be found on the DECtape currently mounted on 
controller B, unit 0 . Associate the ID of the user who entered the 
command with this dataset. Perform the action indicated by switch AB 
( not ABC) on this dataset. No values are associated with the switch. 

The third positional input dataset is a file named F5 and its ex- 
tension is E5. It can be found on the DECtape currently mounted on 
controller B, unit 0 . Associate the ID of the user who entered the com- 
mand with this dataset. No switches are associated with this dataset. 

The fourth and subsequent input datasets are not required. 

A command of the following form: 

Dataset Specification, < Dataset Specification 

terminator 

could be interpreted to mean "do not generate the second and subsequent 
datasets", but this is accomplished by: 

Dataset Specification < Dataset Specification 

terminator 


as well. 
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APPENDIX A 


PHYSICAL DEVICE NAMES 


MNEMONIC 


DEVICE 


DC 

RC11 Disk 

DF 

RFll Disk 

DK 

RKll Disk 

DT 

DECtape (DT11) 

KB 

ASR-33 Keyboard/Teletype 

LP 

Line Printer (LP11) 

PP 

High Speed Paper Tape Punch 

PR 

High Speed Paper Tape Reader 

PT 

ASR-33 Paper Tape Device 


NOTE: Device mnemonics may be three characters on a particular 

system. The third character is generally assigned if there 
is more than one controller, e.g.: 

DTA for DECtape controller "A" 

DTB for DECtape controller "B" 
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APPENDIX B 


EMT CODES 


Code Usage 


0 

. WAITR 

1 

.WAIT 

2 

.WRITE 

3 

** 

4 

. READ 

5 

** 

6 

. INIT 

7 

. RLSE 

10 

.TRAN 

11 

. BLOCK 

12 

.SPEC 

13 

.STAT 

14 

.LOOK 

15 

.ALLOC 

16 

. OPENx 

17 

.CLOSE 

20 

.RENAM 

21 

. DELET 

22 

. APPND 

23 

* * 

24 

.KEEP 

25-27 

** 

30-31 

* 

32 

Diagnostic Print 


Reserved for Monitor internal communication 
Reserved for future Monitor expansion 
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APPENDIX B (Cont'd) 


EMT CODES 


Code 


Usage 


33,34 

35-37 

40 

41 

42 

43-55 

56,57 

60 

61,62 

63-77 

100-117 

120-137 

140-167 


* 

** 

* 

General Utilities 

General Conversions 
* 

Command String Interpreter 
.EXIT 
* 

** 

(reserved for Communications 
Executive, COMTEX-11) 

(reserved for Real Time Monitor, 
RSX-11) 

(reserved for user-implemented 
routines) 


* Reserved for Monitor internal communication 
** Reserved for future Monitor expansion 
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APPENDIX C 


SUBSIDIARY ROUTINE ASSIGNMENTS 


The routines associated with the GLOBAL NAMES specified below are 
called by the REQUEST processor as indicated: 


(blank) = subsidiary routine is never called 


X = subsidiary routine is called when and 
only when a file structured device is 
referenced 

L = subsidiary routine is called when and 
only when a linked file is referenced 

C = subsidiary routine is called when and 
only when a contiguous file is refer- 
enced 

D = subsidiary routine is called when and 
only when DECtape is referenced 


For example, if a user wants all .OPENI processing routines core resi- 
dent, he would put the following assembler directive in his program: 


. GLOBL OPN. , FOP . , LUK . , CKX . 



Global Name 

Request 

FOP. 

FCR. 

FCL . 

LUK. 

LBA. 

GMA. 

CBA. 

CKX. 

DLN . 

DCN . 

AP2 . 

GNM. 

.READ/WRITE 




■ 








X 

.OPENU 

X 



X 

■ 

■ 

9 

X 


■ 

■ 


. OPENO 


X 


X 

K9 

X 

9 

X 

■ 

■ 


■ 

. OPENE 

X 



X 

a 

X 


X 




■ 

. OPENI 

X 



X 




X 





. OPENC 

X 



X 




X 



■ 

■ 

. CLOSE 



X 

■ 




_ 


— 

■ 


. ALLOC 




X 



X 

a 





.DELET 




X 

■ 

■ 


X 

L 

C 

"" ' 


.RENAM 




X 




a 



— — — 


. APPND 




X 




a 



— 1 

D 


.LOOK 




a 









xrppp 

T*VDnr 




a 

■ 

■ 

■ 

X 



■ 

■ 
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APPENDIX D 


SUMMARY OF MONITOR COMMANDS 


Command Usage 

Commands to Allocate System Resources 

ASsign Assign a physical device to a logical device 

name 

OTher Pass Monitor control to another device 


Commands to Manipulate 

Core Images 


RUn 

Load and begin a program 


GEt 

Load a program 


DUmp 

Write a specified core area onto 
in absolute binary 

a device 

SAve 

Write a program onto a device in 
format 

loader 


Commands to Start a Program 

BEgin Starts execution of a program 

Continue Resumes execution of a halted program 

REstart Restarts execution of a previously operat- 

ing program 


Commands to Stop a Program 


STop 

Halt the current program, including any I/O 
in progress 

WAit 

Halts current program after finishing any 
I/O in progress 

Kill 

Halts the current program, finishes any 

I/O in progress, closes all open files, 
and passes control back to the Monitor. 

Commands to Exchange 

Information with the System 

DAte 

Fetch/Specify date 

Time 

Fetch/Specify time 

LOgin 

Enter User Identification Code 
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Command 


Usage 


MOdi fy 


Modify contents of memory location 


Finish 


Log off system 


Miscellaneous Commands 
ECho 
PRint 


ENd 

ODt 


Disable/enable keyboard echo to user program 

Disable/enable Teleprinter output from user 
program 

End input from a device 

Begin operation of Octal Debugger (ODT) 
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Mnemonic 

Function 


Macro Call 
(See notes) 

Assembly Language 
Expansion 
(See notes) 

Refe.r 

to 

Page 

. ALLOC 

Allocate a Contiguous 

. ALLOC 

LNKBLK, FILBLK,N 

MOV 

#N,-(SP) 

2-30 


File 



MOV 

#FILBLK,- (SP) 






MOV 

# LNKBLK,- (SP) 






EMT 

15 


. APPND 

Append to a Linked 

.APPND 

LNKBLK , FIRST , SECOND 

MOV 

#SECOND,- (SP) 

2-34 


File 



MOV 

#FIRST,- (SP) 






MOV 

# LNKBLK, -(SP) 






EMT 

22 


. BIN2D 

Convert Binary to 

. BIN2D 

ADD R, WORD 

MOV 

#WORD,- (SP) 

2-45 


Decimal ASCII 



MOV 

#ADDR,- (SP) 






MOV 

#3,- (SP) 






EMT 

4 2 


. BIN20 

Convert Binary to 

. BIN2 0 

ADD R, WORD 

MOV 

#WORD,- (SP) 

2-46 





MOV 

#ADDR , - (SP) 






MOV 

#5 ,- (SP) 






EMT 

42 


. BLOCK 

Transfer a Block 

. BLOCK 

LNKBLK , BLKBLK 

MOV 

# BLKBLK,- (SP) 

2-7 





MOV 

# LNKBLK, - (SP) 

2-25 





EMT 

11 

2-62 

.CLOSE 

Close a Dataset 

.CLOSE 

LNKBLK 

MOV 

# LNKBLK, - (SP) 

2-21 





EMT 

17 


.CORE 

Obtain Core Size 

.CORE 


MOV 

#100,- (SP) 

2-3 8 





EMT 

41 


.CSI1 

CSI Interface - 

.CSI1 

CMDBUF 

MOV 

# CMDBUF, - (SP) 

2-47 


part 1 



EMT 

56 


. CSI2 

CSI Interface - 

. CSI 2 

CSIBLK 

MOV 

#CSIBLK,- (SP) 

2-48 


part 2 



EMT 

57 



>Y OF MONITOR PROGRAMMED REQUESTS 



Mnemonic 


Function 


Macro Call 


.DATE 

Obtain Date 

.DATE 

.DELET 

Delete a File 

.DELET LNKBLK , FILBLK 

.D2BIN 

Convert Decimal ASCII 
to Binary 

. D2BIN ADDR 

.EXIT 

Exit to Monitor 

.EXIT 

. GTUIC 

Get Current UIC 

.GTUIC 

. INIT 

Initialize a Dataset 

.INIT LNKBLK 

.KEEP 

Protect a File 

.KEEP LNKBLK, FILBLK 

-LOOK 

Directory Search 

.LOOK LNKBLK, FILBLK 

.MONF 

Obtain full Monitor 
size 

.MONF 

. MONR 

Obtain size of 
resident Monitor 

.MONR 

. OPENx 

Open a Dataset 

.OPENx LNKBLK, FILBLK 


Refer 

Assembly Language to 

Expansion Page 

MOV # 103 , - (SP) 2-41 

EMT 41 

MOV #FILBLK , - (SP) 2-32 

MOV #LNKBLK,- (SP) 

EMT 21 

MOV #ADDR,-(SP) 2-44 

MOV #2 ,- (SP) 

EMT 42 

EMT 60 2-37 

MOV #105,- (SP) 2-41 

EMT 41 

MOV #LNKBLK,- (SP) 2-15 

EMT 6 

MOV #FILBLK,- (SP) 2-36 

MOV #LNKBLK,- (SP) 

EMT 24 

MOV #FILBLK,- (SP) 2-35 

MOV #LNKBLK,- (SP) 

EMT 14 

MOV #102, -(SP) 2-39 

EMT 41 

MOV #101,- (SP) 2-39 

EMT 41 


MOV #CODE,FILBLK-2 
MOV #FILBLK,- (SP) 
MOV #LNKBLK,- (SP) 
EMT 16 
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Refer 


Mnemonic 

Function 

Macro Call 

Assembly Language 

Exp ansion 

to 

Page 




(CODE = 1 for .OPENU 

2 for .OPENO 

3 for .OPENE 

4 for .OPENI 

13 for .OPENC 


. 02BIN 

Convert Octal ASCII 
to Binary 

. D2BIN ADDR 

MOV #ADDR,-(SP) 

MOV # 4 , - (SP) 

EMT 42 

2-44 

. RADPK 

RADIX-50 ASCII Pack 

.RADPK ADDR 

MOV #ADDR, - (SP) 

MOV #0,-(SP) 

EMT 42 

2-42 

. RAD UP 

RADIX-50 ASCII 

Unpack 

.RADUP ADDR, 

MOV #WORD , - ( SP ) 

MOV #ADDR, - (SP ) 

MOV #1,-(SP) 

EMT 42 

2-43 

.READ 

Read from Device 

.READ LNKBLK , BUFHDR 

MOV #BUFHDR,- (SP) 

MOV # LNKBLK,- (SP) 

EMT 4 

2-4 

2-14 

2-22 

. RENAM 

Rename a file 

. RENAM LNKBLK , OLDNAM , NEWNAM 

MOV # NEWNAM,- (SP) 

MOV #OLDNAM,- (SP) 

MOV # LNKBLK,- (SP) 

EMT 20 

2-33 

. RLSE 

Release a Dataset 

.RLSE LNKBLK 

MOV # LNKBLK, - (SP) 

EMT 7 

2-16 

. RSTRT 

Set REstart address 

.RSTRT ADDR 

MOV #ADDR, - (SP) 

MOV #2 , - (SP) 

EMT 41 

2-38 

.SPEC 

Special Function 

.SPEC LNKBLK, CODE 

MOV #Code , - (SP) 

MOV # LNKBLK, - (SP) 

2-28 


EMT 12 



Mnemonic 

Function 

Macro Call 

Assembly Language 
Expansion 

Refer 

to 

Page 

.STAT 

Obtain Device Status 

.STAT LNKBLK 

MOV 

# LNKBLK , - (SP) 

2-29 




EMT 

13 

2-57 

.TIME 

Obtain Time of Day 

. TIME 

MOV 

#104, -(SP) 

2-41 




EMT 

41 


.TRAN 

Transfer absolute 

.TRAN LNKBLK , TRNBLK 

MOV 

#TRNBLK,- (SP) 

2-9 


block 


MOV 

#LNKBLK,- (SP) 

2-27 




EMT 

10 

2-63 

.TRAP 

Set TRAP vector 

.TRAP STATUS, ADDR 

MOV 

#ADDR,- (SP) 

2-37 




MOV 

#STATUS,- (SP) 





MOV 

#1,-(SP) 





EMT 

41 


.WAIT 

Wait for Completion 

.WAIT LNKBLK 

MOV 

#LNKBLK , - (SP) 

2-24 




EMT 

1 


. WAITR 

Wait for Completion; 

•WAITR LNKBLK, ADDR 

MOV 

#ADDR , - (SP) 

2-25 


Return to ADDR 


MOV 

# LNKBLK,- (SP) 





EMT 

0 


.WRITE 

Write on a Device 

.WRITE LNKBLK, BUFHDR 

MOV 

#BUFHDR,- (SP) 

2-4 




MOV 

#LNKBLK,- (SP) 

2-14 




EMT 

2 


NOTES : 

ADDR a memory address 





BLKBLK address of 

BLOCK Block 





BUFHDR address of 

Line Buffer Header 





CMDBUF address of 

Command String Buffer 





CSIBLK address of 

Command String Interpreter Control Block 



FILBLK address of 

Filename Block 





FIRST address of 

Filename Block of file which is 

appended to 




NOTES: CCont'd) 


LNKBLK 

N 

NEWNAM 

OLDNAM 

SECOND 

SP 

TRNBLK 


address of Link Block 

number of 64-word segments requested 

address of Filename Block containing the file's new name 
address of Filename Block containing the file's old name 
address of Filename Block of file which is appended 
Stack Pointer (register R6) 
address of TRAN Block 



APPENDIX F 


DEVICE DRIVERS 


Device drivers are classified by the types of devices they serve. There 
are : 

• Terminal devices such as keyboards or displays that 
interface directly to human operators, 

• Bulk storage devices such as disks or DECtapes which 
are usually file or directory structured. 

• Others 

Terminal Device Drivers 

Drivers for terminal devices are usually the most complex because: 

• People are unpredictable and demanding. they re- 
quire flexibility and understanding. 

• Terminals are usually inexpensive and depend on 
software to perform what other devices manage with 
hardware. 

A terminal driver must be designed to respond not only to valid commands 
from the knowledgeable programmer, but also to a variety of errors from 
less experienced people Such a driver must give the operator the op- 
portunity to correct any mistakes he may discover as he uses the device, 
must not depend on any particular time between inputs, and cannot re- 
quire a particular length of input. Rather, a terminal must accept com- 
mands to ignore characters or lines at the leisure of the operator, of 
whatever length he so desires, subject only to the limitation of the 

rJ TTQV I C Ul’I'P -PrM* 

-L O l-i -i- Cl e 

The ASR-33 Teleprinter Driver 
The Keyboard 

When an operator enters data from the keyboard, the data is stored in 
a buffer within the driver until requested by the program. As the data 
is processed for transfer to the program, it is echoed back to the tele- 
printer. While the data is in the buffer, it can be added to, deleted/ 
or Modified by the operator. Once passed to the Monitor, the data can- 
not be directly changed. Keyboard keys which are recognized as special 
functions by the driver are : 
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RUBOUT 


which erases the preceding character from the buffer 
and echoes deleted characters between \ . . . .\ 

CTRL/U which deletes the current line and echoes as +U 


RETURN 


TAB 


which places a carriage return followed by a line feed 
into the buffer, and echoes the same to the teleprinter 

is simply echoed as spaces up to the next stop posi- 
tion. The TAB code is placed into the buffer. 


* ESC which notifies the Monitor that it is not to take ac- 

tion on the next character. This allows the program- 
mer to pass to the user program or systems program a 
code which is normally interpreted by the monitor in 
a special way. For example, ESC CTRL C will not cause 
the Monitor to expect a command. Similarly, preced- 
ing CTRL U by ESC will remove its erasing facility. 

The Teleprinter 

is replaced with spaces up to the next stop position 
is discarded 


TAB 

RUBOUT 


* 

On some Teletypes, this appears as ALTMOD. 
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APPENDIX 


GLOSSARY AND ABBREVIATIONS 


Bit map 


Buffer 

Buffer Use Table 


Contiguous file 

Core Bit Map 

Core image 

CSI 

DAT 

Dataset 

DDB 

Default device 


Driver, device 


Fatal error 

File 


A table describing the availability of 
space. Each bit in the table indicates 
the state (occupied or free) or one 
segment of storage, for example a 
block on a bulk storage device. 

A storage area. 

A bit map in the permanently resident 
monitor, which describes the availa- 
bility of buffers in the free core 
area . 

A file consisting of physically con- 
tiguous blocks on a bulk storage de- 
vice . 

That portion of a Permanent Bit Map 
which happens to be in core. Not to 
be confused with the Buffer Use Table. 

A copy of what a program or other data 
would look like if it were in core. 

Command String Interpreter. 

Device Assignment Table. 

A logical collection of data which is 
treated as an entity by a program. 

Dataset Data Block. 

The device specified in the linkblock 
of a dataset, and which is used for 
I/O operations on that dataset if 
there is no other device assigned in 
a DAT entry for the dataset. 

The minimal routine which controls 
physical hardware activities on a per- 
ipheral device. The device driver is 
the interface between a device and 
the common, device- independent I/O code 
in the monitor. 


An error from which a user's program 
cannot recover. 

A physical collection of data which 
resides on a directory-structured de- 
vice and is referenced through its name. 
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FBM 


FIB 

File structure 


Interleave factor 


Julian Date 


KSB 

Linked file 


Linker 


Load Module 


File Bit Map - A device-resident bit 
map with bits flagged for for the 
blocks used for a single file. Used 
on DECtape to aid in the deletion pro- 
cess . 

File Information Block 

The manner in which files are organ- 
ized on a bulk storage device. Each 
of the files of a user is referenced 
through an entry in that user's User 
File Directory. Each User File Direc- 
tory on the device is, in turn, refer- 
enced through an entry in the Master 
File Directory. 

The optimal minimum distance, measured 
in number of physical device blocks, 
between logically adjacent blocks of 
a linked file. Presently it is four 
on all PDP-11 bulk storage devices. 

For example, if physical block N is 
assigned to block 1 of a linked file, 
then physical block N+4 would be the 
closest device block that could be 
assigned to block 2 of that file. 

A 5-digit (decimal) numerical repre- 
sentation of the date, in which the 
two high-order digits give the year 
(1900=00, 1999=99) and the three low- 
order digits give the day within the 
year (January 1 = 001, December 31 
= 365 (366 for leap year)). For example, 
January 28, 1971 is represented as 
71028. 

Keyboard Swap Buffer 

A file consisting of a set of blocks 
within which an ordering is specified 
through the use of a link word imbedded 
within each block. 

A systems program which creates a load 
module to be loaded into core memory. 
The linker relocates and links inter- 
nal and external symbols to provide 
communication between independently 
assembled programs. 

The output of the linker. A program 
in absolute binary form (a core image) 
ready for loading and executing on a 
PDP-11. 


MFD 


Master File Directory 



MRT 

Monitor Residency Table 

MSB 

Monitor Swap Buffer 

Object Module 

The relocatable binary output of an 
assembler or compiler. 

Operator 

7\ -? /-» O -1- -J T"» TaT 1 f h 

/-i ^uuuuuux vu *» — w*-. ■ — - — 

Monitor through the keyboard. 

Parity bit 

A binary digit appended to an array of 
bits to make the sum of all the bit 
values always odd or always even. 

PBM 

Permanent Bit Map - A bit map which 
describes the availability of space 
on a DECtape or disk. It resides on 
the device it describes, and can be 
read into core in segments, called 

Core Bit Maps, for reference or updat- 
ing. 

Radix-50 packed 
ASCII 

A format in which 3 ASCII characters 
(from a subset of all ASCII charac- 
ters) are packed into a single 16-bit 
word. 

SAM 

Swap Area Manager 

SAL 

A friend of SAM. 

Swapping 

The movement of programs or program 
sections from secondary storage to 
core . 

Table 

A collection of data in a form suitable 
for ready reference. 

UFD 

User File Directory. 

UIC 

User Identification Code 

User 

The person who is using the Monitor. 

He may use the Monitor as an opera- 
tor, or via a program. 

User program 

Any program written by a user to run 
under the Monitor. 
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HOW 


OBTAIN SOFTWARE INFORMATION 


Announcements for new and revised software, as well as programming 
notes, software problems, and documentation corrections are published 
by Software Information Service in the following newsletters. 

Digital Software News for the PDP-8 & PDP-12 

Digital Software News for the PDP-11 

Digital Software News for the PDP-9/15 Family 

These newsletters contain information applicable to software available 
from Digital's Program Library. Articles in Digital Software News up- 
date the cumulative Software Performance Summary which is contained 
in each basic kit of system software for new computers. To assure that 
the monthly Digital Software News is sent to the appropriate software 
contact at your installation, please check with the Software Special- 
ist or Sales Engineer at your nearest Digital office. 

Questions or problems concerning DEC software should be reported to 
the Software Specialist. In cases where no Software Specialist is avail- 
able, please send a Software Performance Report form with details of 
the problem to: 

Software Information Service 
Digital Equipment Corporation 
146 Main Street, Bldg. 3-5 
Maynard, Massachusetts 01754 

These forms which are available without charge from the Program 
Library, should be fully filled out and accompanied by Teletype output 
as well as listings or tapes of the user program to facilitate a complete 
investigation. An answer will be sent to the individual and appropriate 
topics of general interest will be printed in the newsletter. 

New and revised software and manuals. Software Performance Report 
forms, and software price lists are available from the Program Library. 
When ordering, include the document number and a brief description of 
the program or manual requested. Revisions of programs and documents 
will be announced in the newsletters. Direct all inquiries and requests 
to : 

Program Li brary 
Digital Equipment Corporation 
146 Main Street, Bldg, 1-2 
Maynard, Massachusetts 01754 

Digital Equipment Computer Users Society (DECUS) maintains a user 
library and publishes a catalog of programs as well as the DECUSCOPE 
magazine for its members and non-members who request it. For further 
information please write to: 

D ECUS 

Digital Equipment Corporation 
146 Main Street, Bldg. 3-5 
Maynard, Massachusetts 01754 
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READER'S COMMENTS 

Digital Equipment Corporation maintains a continuous effort to improve the quality and usefulness 
of its publications. To do this effectively we need user feedback *•“ your critical evaluation of 
this manual . 


Please comment on this manual's completeness, accuracy, organization, usability, and read 
ability . 



Did you find errors in this manual? If so, specify by page. 



Please state your position. 


Date: 



Organization: 



Department: 

City: 

State: 

7ip or Country 
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